MailboxSettings.Read
Allows the app to read user's mailbox settings without a signed-in user. Does not include permission to send mail.
Permission Details
Read all user mailbox settings
Allows the app to read user's mailbox settings without a signed-in user. Does not include permission to send mail.
40f97065-369a-49f4-947c-6a255697ae91
Read user mailbox settings
Allows the app to the read user's mailbox settings. Does not include permission to send mail.
87f447af-9fa4-4c32-9dfa-4a57a73d18ce
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
archiveFolder |
string |
Folder ID of an archive folder for the user. |
automaticRepliesSetting |
automaticRepliesSetting |
Configuration settings to automatically notify the sender of an incoming email with a message from the signed-in user. |
dateFormat |
string |
The date format for the user's mailbox. |
delegateMeetingMessageDeliveryOptions |
delegateMeetingMessageDeliveryOptions |
If the user has a calendar delegate, this specifies whether the delegate, mailbox owner, or both receive meeting messages and meeting responses. The possible values are: sendToDelegateAndInformationToPrincipal, sendToDelegateAndPrincipal, sendToDelegateOnly. |
language |
localeInfo |
The locale information for the user, including the preferred language and country/region. |
timeFormat |
string |
The time format for the user's mailbox. |
timeZone |
string |
The default time zone for the user's mailbox. |
userPurpose |
userPurpose |
The purpose of the mailbox. Differentiates a mailbox for a single user from a shared mailbox and equipment mailbox in Exchange Online. The possible values are: user, linked, shared, room, equipment, others, unknownFutureValue. Read-only. |
workingHours |
workingHours |
The days of the week and hours in a specific time zone that the user works. |
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"archiveFolder": "string",
"automaticRepliesSetting": {
"@odata.type": "microsoft.graph.automaticRepliesSetting"
},
"dateFormat": "string",
"delegateMeetingMessageDeliveryOptions": "String",
"language": {
"@odata.type": "microsoft.graph.localeInfo"
},
"timeFormat": "string",
"timeZone": "string",
"userPurpose": "String",
"workingHours": {
"@odata.type": "microsoft.graph.workingHours"
}
}Relationships
Relationships metadata is not available for this permission mapping.
View resource documentationGraph 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 mapped directly from refreshed Microsoft Learn PowerShell snippets.
Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code 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.Me.Outlook.MasterCategories["{outlookCategory-id}"].GetAsync();const options = {
authProvider,
};
const client = Client.init(options);
let outlookCategory = await client.api('/me/outlook/masterCategories/feafe4e8-52ff-488a-817f-cfea7e43ff8b')
.get();Import-Module Microsoft.Graph.Users
# A UPN can also be used as -UserId.
Get-MgUserOutlookMasterCategory -UserId $userId -OutlookCategoryId $outlookCategoryId# 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.me.outlook.master_categories.by_outlook_category_id('outlookCategory-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 or delegated permissions and search for MailboxSettings.Read
Grant Admin Consent
Application permissions always require admin consent.