MailboxFolder.Read | Graph Permissions

Permission Details

Delegated Permission

Read a user's mailbox folders

Allows the app to read the user's mailbox folders, on behalf of the signed-in user.

Permission ID: 52dc2051-4958-4636-8f2a-281d39c6981c

Properties

Microsoft Graph beta exact-category-docs

Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Property	Type	Description
`childFolderCount`	`Int32`Nullable	The number of immediate child folders in the current folder.
`displayName`	`String`Nullable	The display name of the folder.
`id`	`String`	The unique identifier for the folder.
`parentFolderId`	`String`Nullable	The unique identifier for the parent folder of this folder.
`parentMailboxUrl`	`String`Nullable	The routing link to the actual underlying mailbox where the folder physically resides. The folder can be accessed using GET {parentMailboxUrl}/folders/{id}, which treats the entire URL as an opaque string. , , This method is especially important when auto-expanding archiving is enabled for a user's in-place archive mailbox. The user's archive content can span across multiple mailboxes in such scenarios.
`totalItemCount`	`Int32`Nullable	The number of items in the folder.
`type`	`String`Nullable	Describes the folder class type.
`childFolders`	`mailboxFolder collection`	The collection of child folders in this folder.
`items`	`mailboxItem collection`	The collection of items in this folder.
`multiValueExtendedProperties`	`multiValueLegacyExtendedProperty collection`	The collection of multi-value extended properties defined for the mailboxFolder.
`singleValueExtendedProperties`	`singleValueLegacyExtendedProperty collection`	The collection of single-value extended properties defined for the mailboxFolder.

JSON Representation

Microsoft Graph beta exact-category-docs

JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

JSON representation

{
  "@odata.type": "#microsoft.graph.mailboxFolder",
  "displayName": "String",
  "childFolderCount": "Int32",
  "id": "String (identifier)",
  "parentFolderId": "String",
  "parentMailboxUrl": "String",
  "totalItemCount": "Int32",
  "type": "String"
}

Relationships

Microsoft Graph beta exact-category-docs

Relationships is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Relationship	Type	Description
`childFolders`	`mailboxFolder collection`	The collection of child folders in this folder.
`items`	`mailboxItem collection`	The collection of items in this folder.
`multiValueExtendedProperties`	`multiValueLegacyExtendedProperty collection`	The collection of multi-value extended properties defined for the mailboxFolder.
`singleValueExtendedProperties`	`singleValueLegacyExtendedProperty collection`	The collection of single-value extended properties defined for the mailboxFolder.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

No API methods available for this version.

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/admin/exchange/mailboxes/{mailboxId}/folders`
GET `/admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}`
GET `/admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders`
GET `/admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/{mailboxFolderId}`
GET `/admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/delta`
GET `/admin/exchange/mailboxes/{mailboxId}/folders/delta`

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Code Examples

C# / .NET SDK

Get mailboxFolder

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Admin.Exchange.Mailboxes["{mailbox-id}"].Folders["{mailboxFolder-id}"].GetAsync();

JavaScript

Get mailboxFolder

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let mailboxFolder = await client.api('/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/NJWt2LeVEAAAIBDAAAAA==')
	.version('beta')
	.get();

PowerShell

Connect-MgGraph -Scopes "MailboxFolder.Read"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/admin/exchange/mailboxes/{id}/folders"

Python

Get mailboxFolder

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.admin.exchange.mailboxes.by_mailbox_id('mailbox-id').folders.by_mailbox_folder_id('mailboxFolder-id').get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Delegated permissions and search for MailboxFolder.Read

4

Grant Admin Consent

Users can consent to this permission during sign-in.