> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://learn.microsoft.com/en-us/graph/outlook-share-messages-folders).

- **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`.

<Note>
  External Documentation

  To learn more, visit the [Microsoft Outlook documentation](https://learn.microsoft.com/en-us/graph/api/mailfolder-get?view=graph-rest-1.0\&tabs=http).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter                      | Description                                  |
  | ------------------------------ | -------------------------------------------- |
  | Mail Folder ID                 | The ID of the mailFolder to get details for. |
  | User ID or User Principal Name | The ID or userPrincipalName of the user.     |
</div>

## Example Output

```json theme={"dark"}
{
	"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](https://library.blinkops.com/workflows/get-mail-folder-with-microsoft-outlook-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/get-mail-folder-with-microsoft-outlook-and-send-results-via-email/canvas" />
</div>