Skip to main content
Get the mail folder collection directly under the root folder of the signed-in user. The returned collection includes any mail search folders directly under the root. This operation does not return all mail folders in a mailbox, only the child folders of the root folder. To return all mail folders in a mailbox, each child folder must be traversed separately.
  • Least privileged Microsoft Graph permission to access the action via application: Mail.ReadBasic.All.
External DocumentationTo learn more, visit the Microsoft Outlook documentation.

​
Parameters

ParameterDescription
Include Hidden FoldersIndicates whether the new folder is hidden. Setting the property is optional. Once set, you cannot update this property. The default option is to include the hidden folders.
User ID or User Principal NameThe ID or userPrincipalName of the user.

​
Example Output

{
	"@odata.context": "<string>",
	"value": [
		{
			"childFolderCount": 1024,
			"displayName": "string",
			"id": "string (identifier)",
			"parentFolderId": "string",
			"totalItemCount": 1024,
			"unreadItemCount": 1024,
			"isHidden": false,
			"childFolders": [
				{
					"@odata.type": "microsoft.graph.mailFolder"
				}
			],
			"messageRules": [
				{
					"@odata.type": "microsoft.graph.messageRule"
				}
			],
			"messages": [
				{
					"@odata.type": "microsoft.graph.message"
				}
			],
			"multiValueExtendedProperties": [
				{
					"@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty"
				}
			],
			"singleValueExtendedProperties": [
				{
					"@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty"
				}
			]
		}
	]
}

​
Workflow Library Example

List Mail Folders with Microsoft Outlook and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop