MailboxSettings.ReadWriteMicrosoft Graph permission · High risk
Allows the app to create, read, update, and delete user's mailbox settings without a signed-in user. Does not include permission to send mail.
Application permission
High riskRead and write all user mailbox settings. Allows the app to create, read, update, and delete user's mailbox settings without a signed-in user. Does not include permission to send mail.
| ID | 6931bccd-447a-43d1-b442-00a195474933 |
|---|---|
| Consent | Always needs admin consent |
| Risk | As an application permission this reaches every user's data in the tenant, without anyone signed in. |
Delegated permission
Medium riskRead and write user mailbox settings. Allows the app to create, read, update, and delete user's mailbox settings. Does not include permission to send mail.
| ID | 818c620a-27a9-40bd-a6a5-d96f7d610b4b |
|---|---|
| Consent | Users can consent, if your consent settings allow it |
| Risk | Reads or changes the signed-in user's content, limited to what that user can access. |
Grant it to an app
In the portal: App registrations › your app › API permissions › Add a permission › Microsoft Graph › Application permissions, then grant admin consent. Or with Graph PowerShell:
Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All"
$graph = Get-MgServicePrincipal -Filter "appId eq '00000003-0000-0000-c000-000000000000'"
$app = Get-MgServicePrincipal -Filter "appId eq '<your app's client id>'"
New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $app.Id `
-PrincipalId $app.Id -ResourceId $graph.Id -AppRoleId "6931bccd-447a-43d1-b442-00a195474933"Ask for it when signing in
Delegated permissions act as the signed-in user, so the app can never do more than that user can.
Connect-MgGraph -Scopes "MailboxSettings.ReadWrite"Which apps already have it?
# Apps that hold MailboxSettings.ReadWrite as an application permission
Connect-MgGraph -Scopes "Application.Read.All"
$graph = Get-MgServicePrincipal -Filter "appId eq '00000003-0000-0000-c000-000000000000'"
Get-MgServicePrincipalAppRoleAssignedTo -ServicePrincipalId $graph.Id -All |
Where-Object AppRoleId -eq "6931bccd-447a-43d1-b442-00a195474933" |
Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime# Apps with delegated consent for MailboxSettings.ReadWrite
Connect-MgGraph -Scopes "Application.Read.All", "Directory.Read.All"
$graph = Get-MgServicePrincipal -Filter "appId eq '00000003-0000-0000-c000-000000000000'"
Get-MgOauth2PermissionGrant -All |
Where-Object { $_.ResourceId -eq $graph.Id -and ($_.Scope -split " ") -contains "MailboxSettings.ReadWrite" } |
Select-Object ClientId, ConsentType, PrincipalId