List mail folders - Automate.ax

outlook.listMailFolders returns top-level folders or a selected folder’s direct children.

Example

automations/list-outlook-folders.automation.ts

import { automation } from "automate.ax"
import { outlook } from "automate.ax/outlook"

export default automation("List Outlook folders", () => {
  outlook.listMailFolders({
    parentFolder: "Archive",
    includeHidden: false,
    limit: 100,
  })
})

Inputs

Input	Type	Required	Default	Description
`parentFolder`	`string`	No	Mailbox root	Display path, ID, or well-known name. The action returns its direct children.
`includeHidden`	`boolean`	No	`false`	Includes hidden folders.
`limit`	`number`	No	`100`	Maximum across Graph pages, 1–10,000.
Second argument: `{ account }`	`string \| IntegrationAccountReference<"microsoft">`	No	Project default	Microsoft binding.

Output

Returns folders with folderId, displayName, childFolderCount, totalItemCount, unreadItemCount, and isHidden. Numeric counts default to zero and isHidden to false if Graph omits them. Folder names match case-insensitively across the full hierarchy. Use a path such as Projects/Launch or an ID when duplicate names would be ambiguous.