Skip to main content

Get Mail Folder

Retrieve the properties and relationships of a message folder object.

The following list shows the two existing scenarios where an app can get another user's mail folder:

  • If the app has application permissions.
  • If the app has the appropriate delegated permissions from one user, and another user has shared a mail folder with that user, or, has given delegated access to that user. For more details, see Get Outlook messages in a shared or delegated folder.
  • Least privileged Microsoft Graph permission to access the action via application: Mail.ReadBasic.All.
  • Higher Microsoft Graph permission to access the action via application: Mail.ReadWrite, Mail.Read.
External Documentation

To learn more, visit the Microsoft Outlook documentation.

Parameters

ParameterDescription
Mail Folder IDThe ID of the mailFolder to get details for.
User ID or User Principal NameThe ID or userPrincipalName of the user.

Example Output

{
"id": "AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAAAAEJAAA=",
"displayName": "Sent Items",
"parentFolderId": "AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAAAAEIAAA=",
"childFolderCount": 0,
"unreadItemCount": 0,
"totalItemCount": 1,
"sizeInBytes": 53857,
"isHidden": false
}

Workflow Library Example

Get Mail Folder with Microsoft Outlook and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop