Mail-Advanced.ReadWrite
Allows the app to create, read, update, and delete email, including contents of non-draft emails in user mailboxes, on behalf of the signed-in user. Does not include permission to send mail.
In short
Mail-Advanced.ReadWrite is a delegated permission in the Microsoft Graph API, grouped under the Mail-Advanced category. Allows the app to create, read, update, and delete email, including contents of non-draft emails in user mailboxes, on behalf of the signed-in user. Does not include permission to send mail. It grants read and write access to resources. This delegated permission requires admin consent.
Permission Details
Read and write the user's mail, including modifying existing non-draft mails
Allows the app to create, read, update, and delete email, including contents of non-draft emails in user mailboxes, on behalf of the signed-in user. Does not include permission to send mail.
f3af82f6-18e0-4a41-8dc8-a03c11854a8d
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
childFolderCount |
Int32Nullable |
The number of immediate child mailFolders in the current mailFolder. |
displayName |
StringNullable |
The mailFolder's display name. |
id |
String |
The mailFolder's unique identifier. |
isHidden |
BooleanNullable |
Indicates whether the mailFolder is hidden. This property can be set only when creating the folder. Find more information in Hidden mail folders. |
parentFolderId |
StringNullable |
The unique identifier for the mailFolder's parent mailFolder. |
totalItemCount |
Int32Nullable |
The number of items in the mailFolder. |
unreadItemCount |
Int32Nullable |
The number of items in the mailFolder marked as unread. |
childFolders |
mailFolder collection |
The collection of child folders in the mailFolder. |
messageRules |
messageRule collection |
The collection of rules that apply to the user's Inbox folder. |
messages |
message collection |
The collection of messages in the mailFolder. |
multiValueExtendedProperties |
multiValueLegacyExtendedProperty collection |
The collection of multi-value extended properties defined for the mailFolder. Read-only. Nullable. |
singleValueExtendedProperties |
singleValueLegacyExtendedProperty collection |
The collection of single-value extended properties defined for the mailFolder. Read-only. Nullable. |
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"childFolderCount": 1024,
"displayName": "string",
"id": "string (identifier)",
"parentFolderId": "string",
"totalItemCount": 1024,
"unreadItemCount": 1024,
"isHidden": false,
"childFolders": [
{
"@odata.type": "microsoft.graph.mailFolder"
}
],
"messageRules": [
{
"@odata.type": "microsoft.graph.messageRule"
}
],
"messages": [
{
"@odata.type": "microsoft.graph.message"
}
],
"multiValueExtendedProperties": [
{
"@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty"
}
],
"singleValueExtendedProperties": [
{
"@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty"
}
]
}
Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
childFolders |
MailFolder collection |
The collection of child folders in the mailFolder. |
messageRules |
messageRule collection |
The collection of rules that apply to the user's Inbox folder. |
messages |
Message collection |
The collection of messages in the mailFolder. |
multiValueExtendedProperties |
multiValueLegacyExtendedProperty collection |
The collection of multi-value extended properties defined for the mailFolder. Read-only. Nullable. |
singleValueExtendedProperties |
singleValueLegacyExtendedProperty collection |
The collection of single-value extended properties defined for the mailFolder. Read-only. Nullable. |
operations |
mailFolderOperation collection |
The collection of long-running operations in the mailFolder. |
userConfigurations |
userConfiguration collection |
The user configuration objects associated to the mailFolder. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
No API methods available for this version.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
| Methods |
|---|
POST
/me/mailFolders/{mailFolderId}/importMime
|
POST
/users/{usersId}/mailFolders/{mailFolderId}/importMime
|
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
using Azure.Identity;
using Microsoft.Graph;
var scopes = new[] { "Mail-Advanced.ReadWrite" };
var credential = new InteractiveBrowserCredential(
new InteractiveBrowserCredentialOptions
{
ClientId = "YOUR_CLIENT_ID",
TenantId = "YOUR_TENANT_ID",
RedirectUri = new Uri("http://localhost")
});
var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
.WithUrl("https://graph.microsoft.com/v1.0/me/mailFolders/{id}/importMime")
.GetAsync();
import { Client } from "@microsoft/microsoft-graph-client";
import { InteractiveBrowserCredential } from "@azure/identity";
const credential = new InteractiveBrowserCredential({
clientId: "YOUR_CLIENT_ID",
tenantId: "YOUR_TENANT_ID",
redirectUri: "http://localhost"
});
const token = await credential.getToken(["Mail-Advanced.ReadWrite"]);
const client = Client.init({
authProvider: (done) => done(null, token.token)
});
const response = await client.api("/me/mailFolders/{id}/importMime").get();
Connect-MgGraph -Scopes "Mail-Advanced.ReadWrite"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/me/mailFolders/{id}/importMime"
from azure.identity import InteractiveBrowserCredential
import requests
credential = InteractiveBrowserCredential(
client_id="YOUR_CLIENT_ID",
tenant_id="YOUR_TENANT_ID"
)
token = credential.get_token("Mail-Advanced.ReadWrite")
response = requests.get(
"https://graph.microsoft.com/v1.0/me/mailFolders/{id}/importMime",
headers={"Authorization": f"Bearer {token.token}"}
)
print(response.json())
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 Delegated permissions and search for Mail-Advanced.ReadWrite
Grant Admin Consent
This delegated permission requires admin consent.
Frequently asked questions
What is the Mail-Advanced.ReadWrite Microsoft Graph permission?
Mail-Advanced.ReadWrite is a delegated permission in the Microsoft Graph API, grouped under the Mail-Advanced category. Allows the app to create, read, update, and delete email, including contents of non-draft emails in user mailboxes, on behalf of the signed-in user. Does not include permission to send mail. It grants read and write access to resources. This delegated permission requires admin consent. It is mapped to the Microsoft Graph mailfolder resource type. 2 documented Microsoft Graph REST methods require it.
Is Mail-Advanced.ReadWrite an application or a delegated permission?
Mail-Advanced.ReadWrite is a delegated permission only. It grants access on behalf of a signed-in user and cannot be used for app-only access.
Does Mail-Advanced.ReadWrite require admin consent?
This delegated permission requires admin consent.
What is the permission ID (GUID) for Mail-Advanced.ReadWrite?
For Mail-Advanced.ReadWrite, the delegated (OAuth2 scope) ID is f3af82f6-18e0-4a41-8dc8-a03c11854a8d. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.