MailFolderList

Summary

• Lists mail folders to support filing, move operations, and navigation.

Graph Endpoint

• Top level: GET /me/mailFolders

• Children: GET /me/mailFolders/{parentId}/childFolders

Parameters

Optional

• parentId: string — If provided, lists child folders of the given folder.

• top: number — 1..100

Usage (app.businessFunction)

Top-level folders

app.businessFunction({
  functionName: 'MicrosoftGraph',
  methodName: 'Mail',
  operation: 'FolderList',
  parameters: {
    top: 50
  }
})

Child folders of a parent

app.businessFunction({
  functionName: 'MicrosoftGraph',
  methodName: 'Mail',
  operation: 'FolderList',
  parameters: {
    parentId: 'AAMkAGI2N...'
  }
})

Response

{
  "items": [
    {
      "id": "AQMkAGI2N...",
      "displayName": "Archive",
      "childFolderCount": 3,
      "unreadItemCount": 12,
      "totalItemCount": 120
    }
  ],
  "nextLink": "..."
}