List Mail Folders - BlinkOps Documentation

Parameters
Example Output
Workflow Library Example

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"
				}
			]
		}
	]
}