MailboxSettings.Read
Allows the app to the read user's mailbox settings. Does not include permission to send mail.
Graph Methods
Type: A = Application Permission, D = Delegate Permission
Ver |
Type |
Method |
V1 |
A,D |
GET /me/mailboxSettings |
V1 |
A,D |
GET /me/mailFolders/inbox/messagerules |
V1 |
A,D |
GET /me/mailFolders/inbox/messageRules |
V1 |
A,D |
GET /me/mailFolders/inbox/messagerules/{id} |
V1 |
A,D |
GET /me/mailFolders/inbox/messageRules/{id} |
V1 |
A,D |
GET /me/outlook/masterCategories |
V1 |
A,D |
GET /me/outlook/masterCategories/{id} |
V1 |
A,D |
GET /users/{id | userPrincipalName}/mailFolders/inbox/messagerules |
V1 |
A,D |
GET /users/{id | userPrincipalName}/mailFolders/inbox/messageRules |
V1 |
A,D |
GET /users/{id | userPrincipalName}/mailFolders/inbox/messagerules/{id} |
V1 |
A,D |
GET /users/{id | userPrincipalName}/mailFolders/inbox/messageRules/{id} |
V1 |
A,D |
GET /users/{id|userPrincipalName}/mailboxSettings |
V1 |
A,D |
GET /users/{id|userPrincipalName}/outlook/masterCategories |
V1 |
A,D |
GET /users/{id|userPrincipalName}/outlook/masterCategories/{id} |
Delegate Permission
|
|
Id |
87f447af-9fa4-4c32-9dfa-4a57a73d18ce |
Consent Type |
User |
Display String |
Read user mailbox settings |
Description |
Allows the app to the read user's mailbox settings. Does not include permission to send mail. |
Application Permission
|
|
Id |
40f97065-369a-49f4-947c-6a255697ae91 |
Display String |
Read all user mailbox settings |
Description |
Allows the app to read user's mailbox settings without a signed-in user. Does not include permission to send mail. |
Resources
Property |
Type |
Description |
externalAudience |
externalAudienceScope |
The set of audience external to the signed-in user's organization who will receive the ExternalReplyMessage, if Status is AlwaysEnabled or Scheduled . The possible values are: none , contactsOnly , all . |
externalReplyMessage |
string |
The automatic reply to send to the specified external audience, if Status is AlwaysEnabled or Scheduled . |
internalReplyMessage |
string |
The automatic reply to send to the audience internal to the signed-in user's organization, if Status is AlwaysEnabled or Scheduled . |
scheduledEndDateTime |
dateTimeTimeZone |
The date and time that automatic replies are set to end, if Status is set to Scheduled . |
scheduledStartDateTime |
dateTimeTimeZone |
The date and time that automatic replies are set to begin, if Status is set to Scheduled . |
status |
automaticRepliesStatus |
Configurations status for automatic replies. The possible values are: disabled , alwaysEnabled , scheduled . |
Property |
Type |
Description |
bias |
Edm.Int32 |
The time offset of the time zone from Coordinated Universal Time (UTC). This value is in minutes. Time zones that are ahead of UTC have a positive offset; time zones that are behind UTC have a negative offset. |
daylightOffset |
daylightTimeZoneOffset |
Specifies when the time zone switches from standard time to daylight saving time. |
name |
string |
The name of the custom time zone. |
standardOffset |
standardTimeZoneOffset |
Specifies when the time zone switches from daylight saving time to standard time. |
Property |
Type |
Description |
displayName |
string |
A name representing the user's locale in natural language, for example, "English (United States)". |
locale |
string |
A locale representation for the user, which includes the user's preferred language and country/region. For example, "en-us". The language component follows 2-letter codes as defined in ISO 639-1, and the country component follows 2-letter codes as defined in ISO 3166-1 alpha-2. |
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. 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. |
workingHours |
workingHours |
The days of the week and hours in a specific time zone that the user works. |
Property |
Type |
Description |
actions |
messageRuleActions |
Actions to be taken on a message when the corresponding conditions are fulfilled. |
conditions |
messageRulePredicates |
Conditions that when fulfilled, will trigger the corresponding actions for that rule. |
displayName |
String |
The display name of the rule. |
exceptions |
messageRulePredicates |
Exception conditions for the rule. |
hasError |
Boolean |
Indicates whether the rule is in an error condition. Read-only. |
id |
String |
The unique identifier of the rule. Read-only. |
isEnabled |
Boolean |
Indicates whether the rule is enabled to be applied to messages. |
isReadOnly |
Boolean |
Indicates if the rule is read-only and cannot be modified or deleted by the rules REST API. |
sequence |
Int32 |
Indicates the order in which the rule is executed, among other rules. |
Property |
Type |
Description |
displayName |
String |
A unique name that identifies a category in the user's mailbox. After a category is created, the name cannot be changed. Read-only. |
color |
categoryColor |
A pre-set color constant that characterizes a category, and that is mapped to one of 25 predefined colors. See the note below. |
Property |
Type |
Description |
value |
mailboxRecipientType |
Represents the user's recipient or mailbox type in Exchange Online. Possible values are: unknown , user , linked , shared , room , equipment , and others . See the next section for more information. |
Property |
Type |
Description |
daysOfWeek |
dayOfWeek collection |
The days of the week on which the user works. |
endTime |
Edm.TimeOfDay |
The time of the day that the user stops working. |
startTime |
Edm.TimeOfDay |
The time of the day that the user starts working. |
timeZone |
timeZoneBase |
The time zone to which the working hours apply. |