MailboxFolder.Read.All
Allows the app to read all the users' mailbox folders, without signed-in user.
In short
MailboxFolder.Read.All is an application-only permission in the Microsoft Graph API, grouped under the MailboxFolder category. Allows the app to read all the users' mailbox folders, without signed-in user. It grants read-only access to resources. Application permissions always require admin consent.
Permission Details
Read all the users' mailbox folders
Allows the app to read all the users' mailbox folders, without signed-in user.
99280d24-a782-4793-93cc-0888549957f6
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
childFolderCount |
Int32Nullable |
The number of immediate child folders in the current folder. |
displayName |
StringNullable |
The display name of the folder. |
id |
String |
The unique identifier for the folder. |
parentFolderId |
StringNullable |
The unique identifier for the parent folder of this folder. |
totalItemCount |
Int32Nullable |
The number of items in the folder. |
type |
StringNullable |
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. |
wellKnownName |
stringNullable |
The locale-independent well-known name of the folder for folders created by Outlook, such as inbox, sentitems, drafts, deleteditems, or archive. For user-created folders, the value is null. Read-only. |
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"@odata.type": "#microsoft.graph.mailboxFolder",
"displayName": "String",
"childFolderCount": "Int32",
"id": "String (identifier)",
"parentFolderId": "String",
"totalItemCount": "Int32",
"type": "String"
}Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| 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
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
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 docsMicrosoft 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 docsCode Examples
// 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();const options = {
authProvider,
};
const client = Client.init(options);
let mailboxFolder = await client.api('/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/NJWt2LeVEAAAIBDAAAAA==')
.get();Connect-MgGraph -Scopes "MailboxFolder.Read.All"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/admin/exchange/mailboxes/{id}/folders"# Code snippets are only available for the latest version. Current version is 1.x
from msgraph 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
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions and search for MailboxFolder.Read.All
Grant Admin Consent
Application permissions always require admin consent.
Frequently asked questions
What is the MailboxFolder.Read.All Microsoft Graph permission?
MailboxFolder.Read.All is an application-only permission in the Microsoft Graph API, grouped under the MailboxFolder category. Allows the app to read all the users' mailbox folders, without signed-in user. It grants read-only access to resources. Application permissions always require admin consent. It is mapped to the Microsoft Graph mailboxfolder resource type. 12 documented Microsoft Graph REST methods require it.
Is MailboxFolder.Read.All an application or a delegated permission?
MailboxFolder.Read.All is an application permission only. It grants app-only access without a signed-in user and always requires admin consent.
Does MailboxFolder.Read.All require admin consent?
Application permissions always require admin consent.
What is the permission ID (GUID) for MailboxFolder.Read.All?
For MailboxFolder.Read.All, the application (app role) ID is 99280d24-a782-4793-93cc-0888549957f6. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.