Skip to main content
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 DocumentationTo 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