List Mail Folders - BlinkOps Documentation

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

Parameter	Description
Include Hidden Folders	Indicates 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.
Limit	Set the page size of the returned results.
Return All Pages	Automatically fetch all resources, page by page.
User ID or User Principal Name	The 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

Preview this Workflow on desktop

List Email Attachments List Messages Rules

⌘I

​Parameters

​Example Output

​Workflow Library Example

Parameters

Example Output

Workflow Library Example