MailboxFolder.Read.All

Allows the app to read all the users' mailbox folders, without signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the MailboxFolder.Read.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	99280d24-a782-4793-93cc-0888549957f6	-
DisplayText	Read all the users' mailbox folders	-
Description	Allows the app to read all the users' mailbox folders, without signed-in user.	-
AdminConsentRequired	-	-

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /admin/exchange/mailboxes/{mailboxId}/folders
	GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}
	GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders
	GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/{mailboxFolderId}
	GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/delta
	GET /admin/exchange/mailboxes/{mailboxId}/folders/delta
	GET /me/mailFolders/{id}/messages/{id}?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
	GET /me/mailFolders/{id}/messages/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
	GET /me/messages/{id}?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
	GET /me/messages/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
	GET /users/{id\|userPrincipalName}/messages/{id}?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
	GET /users/{id\|userPrincipalName}/messages/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
	POST /admin/exchange/mailboxes/{mailboxId}/folders
	POST /groups/{id}/conversations
	POST /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/reply
	POST /groups/{id}/conversations/{id}/threads/{id}/reply
	POST /groups/{id}/events
	POST /groups/{id}/threads
	POST /groups/{id}/threads/{id}/posts/{id}/reply
	POST /groups/{id}/threads/{id}/reply
	POST /me/calendars
	POST /me/contactFolders
	POST /me/contacts
	POST /me/events
	POST /me/mailFolders
	POST /me/mailFolders/{id}/messages
	POST /me/messages
	POST /users/{id\|userPrincipalName}/calendars
	POST /users/{id\|userPrincipalName}/contactFolders
	POST /users/{id\|userPrincipalName}/contacts
	POST /users/{id\|userPrincipalName}/events
	POST /users/{id\|userPrincipalName}/mailFolders
	POST /users/{id\|userPrincipalName}/messages

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /admin/exchange/mailboxes/{mailboxId}/folders
	GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}
	GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders
	GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/{mailboxFolderId}
	GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders/delta
	GET /admin/exchange/mailboxes/{mailboxId}/folders/delta
	GET /me/mailFolders/{id}/messages/{id}?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
	GET /me/mailFolders/{id}/messages/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
	GET /me/messages/{id}?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
	GET /me/messages/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
	GET /users/{id\|userPrincipalName}/messages/{id}?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
	GET /users/{id\|userPrincipalName}/messages/{id}?$expand=singleValueExtendedProperties($filter=id eq '{id_value}')
	POST /admin/exchange/mailboxes/{mailboxId}/folders
	POST /groups/{id}/conversations
	POST /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/reply
	POST /groups/{id}/conversations/{id}/threads/{id}/reply
	POST /groups/{id}/events
	POST /groups/{id}/threads
	POST /groups/{id}/threads/{id}/posts/{id}/reply
	POST /groups/{id}/threads/{id}/reply
	POST /me/calendars
	POST /me/contactFolders
	POST /me/contacts
	POST /me/events
	POST /me/mailFolders
	POST /me/mailFolders/{id}/messages
	POST /me/messages
	POST /me/notes
	POST /me/outlook/taskFolders
	POST /me/outlook/taskFolders/{id}/tasks
	POST /me/outlook/taskGroups/{id}/taskFolders
	POST /me/outlook/taskGroups/{id}/taskFolders/{id}/tasks
	POST /me/outlook/tasks
	POST /me/todo/lists?$expand=singleValueExtendedProperties($filter=id eq '{singleValueExtendedPropertyId}')
	POST /me/todo/lists/{todoTaskListId}/tasks?$expand=singleValueExtendedProperties($filter=id eq '{singleValueExtendedPropertyId}')
	POST /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}?$expand=singleValueExtendedProperties($filter=id eq '{singleValueExtendedPropertyId}')
	POST /users/{id\|userPrincipalName}/calendars
	POST /users/{id\|userPrincipalName}/contactFolders
	POST /users/{id\|userPrincipalName}/contacts
	POST /users/{id\|userPrincipalName}/events
	POST /users/{id\|userPrincipalName}/mailFolders
	POST /users/{id\|userPrincipalName}/messages
	POST /users/{id\|userPrincipalName}/notes
	POST /users/{id\|userPrincipalName}/outlook/taskFolders
	POST /users/{id\|userPrincipalName}/outlook/taskFolders/{id}/tasks
	POST /users/{id\|userPrincipalName}/outlook/taskGroups/{id}/taskFolders
	POST /users/{id\|userPrincipalName}/outlook/taskGroups/{id}/taskFolders/{id}/tasks
	POST /users/{id\|userPrincipalName}/outlook/tasks

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgUserEvent
	Get-MgUserMessage
	Update-MgUserMessage

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaUserMessage
	Invoke-MgBetaReplyGroupConversationThread
	Invoke-MgBetaReplyGroupConversationThreadPost
	Invoke-MgBetaReplyGroupThread
	Invoke-MgBetaReplyGroupThreadPost
	New-MgBetaGroupConversation
	New-MgBetaGroupEvent
	New-MgBetaGroupThread
	New-MgBetaUserCalendar
	New-MgBetaUserContact
	New-MgBetaUserContactFolder
	New-MgBetaUserEvent
	New-MgBetaUserMailFolder
	New-MgBetaUserMailFolderMessage
	New-MgBetaUserMessage
	New-MgBetaUserOutlookTask
	New-MgBetaUserOutlookTaskFolder
	New-MgBetaUserOutlookTaskFolderTask
	New-MgBetaUserOutlookTaskGroupTaskFolder
	New-MgBetaUserOutlookTaskGroupTaskFolderTask

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: calendar

Property	Type	Description
allowedOnlineMeetingProviders	onlineMeetingProviderType collection	Represent the online meeting service providers that can be used to create online meetings in this calendar. The possible values are: `unknown`, `skypeForBusiness`, `skypeForConsumer`, `teamsForBusiness`.
canEdit	Boolean	`true` if the user can write to the calendar, `false` otherwise. This property is `true` for the user who created the calendar. This property is also `true` for a user who shared a calendar and granted write access.
canShare	Boolean	`true` if the user has permission to share the calendar, `false` otherwise. Only the user who created the calendar can share it.
canViewPrivateItems	Boolean	If `true`, the user can read calendar items that have been marked private, `false` otherwise.
changeKey	String	Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.
color	calendarColor	Specifies the color theme to distinguish the calendar from other calendars in a UI. The property values are: `auto`, `lightBlue`, `lightGreen`, `lightOrange`, `lightGray`, `lightYellow`, `lightTeal`, `lightPink`, `lightBrown`, `lightRed`, `maxColor`.
defaultOnlineMeetingProvider	onlineMeetingProviderType	The default online meeting provider for meetings sent from this calendar. The possible values are: `unknown`, `skypeForBusiness`, `skypeForConsumer`, `teamsForBusiness`.
hexColor	String	The calendar color, expressed in a hex color code of three hexadecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. If the user has never explicitly set a color for the calendar, this property is empty. Read-only.
id	String	The calendar's unique identifier. Read-only.
isDefaultCalendar	Boolean	`true` if this is the default calendar where new events are created by default, `false` otherwise.
isRemovable	Boolean	Indicates whether this user calendar can be deleted from the user mailbox.
isTallyingResponses	Boolean	Indicates whether this user calendar supports tracking of meeting responses. Only meeting invites sent from users' primary calendars support tracking of meeting responses.
name	String	The calendar name.
owner	emailAddress	If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the **o

Graph reference: contact

Property	Type	Description
assistantName	String	The name of the contact's assistant.
birthday	DateTimeOffset	The contact's birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
businessAddress	physicalAddress	The contact's business address.
businessHomePage	String	The business home page of the contact.
businessPhones	String collection	The contact's business phone numbers.
categories	String collection	The categories associated with the contact.
changeKey	String	Identifies the version of the contact. Every time the contact is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
children	String collection	The names of the contact's children.
companyName	String	The name of the contact's company.
createdDateTime	DateTimeOffset	The time the contact was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
department	String	The contact's department.
displayName	String	The contact's display name. You can specify the display name in a create or update operation. Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. To preserve a pre-existing value, always include it as displayName in an update operation.
emailAddresses	emailAddress collection	The contact's email addresses.
fileAs	String	The name the contact is filed under.
generation	String	The contact's suffix.
givenName	String	The contact's given name.
homeAddress	physicalAddress	The contact's home address.
homePhones	String collection	The contact's home phone numbers.
id	String	The contact's unique identifier. !INCLUDE [outlook-beta-id] Read-only.
imAddresses	String collection	The contact's instant messaging (IM) addresses.
initials	String	The contact's initials.
jobTitle	String	The contact’s job title.
lastModifiedDateTime	DateTimeOffset	The time the contact was modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
manager	String	The name of the contact's manager.
middleName	String	The contact's middle name.
mobilePhone	String	The contact's mobile phone number.
nickName	String	The contact's nickname.
officeLocation	String	The location of the contact's office.
otherAddress	physicalAddress	Other addresses for the contact.
parentFolderId	String	The ID of the contact's parent folder.
personalNotes	String	The user's notes about the contact.
primaryEmailAddress	emailAddress	The contact's primary email address.
profession	String	The contact's profession.
secondaryEmailAddress	emailAddress	The contact's secondary email address.
spouseName	String	The name of the contact's spouse/partner.
surname	String	The contact's surname.
tertiaryEmailAddress	emailAddress	The contact's tertiary email address.
title	String	The contact's title.
yomiCompanyName	String	The phonetic Japanese company name of the contact.
yomiGivenName	String	The phonetic Japanese given name (first name) of the contact.
yomiSurname	String	The phonetic Japanese surname (last name) of the contact.

Graph reference: contactFolder

Property	Type	Description
displayName	String	The folder's display name.
id	String	Unique identifier of the contact folder. Read-only.
parentFolderId	String	The ID of the folder's parent folder.

Graph reference: event

Property	Type	Description
allowNewTimeProposals	Boolean	`true` if the meeting organizer allows invitees to propose a new time when responding; otherwise, `false`. Optional. The default is `true`.
attendees	Attendee collection	The collection of attendees for the event.
body	ItemBody	The body of the message associated with the event. It can be in HTML or text format.
bodyPreview	String	The preview of the message associated with the event. It's in text format.
cancelledOccurrences	String collection	Contains occurrenceId property values of canceled instances in a recurring series, if the event is the series master. Instances in a recurring series that are canceled are called canceled occurences. Requires `$select` to retrieve. Only returned in a Get operation that specifies the ID (seriesMasterId property value) of a series master event.
categories	String collection	The categories associated with the event. Each category corresponds to the displayName property of an outlookCategory defined for the user.
changeKey	String	Identifies the version of the event object. Every time the event is changed, ChangeKey changes as well. It allows Exchange to apply changes to the correct version of the object.
createdDateTime	DateTimeOffset	The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
end	DateTimeTimeZone	The date, time, and time zone that the event ends. By default, the end time is in UTC.
hasAttachments	Boolean	Set to true if the event has attachments.
hideAttendees	Boolean	When set to `true`, each attendee only sees themselves in the meeting request and meeting Tracking list. The default is false.
iCalUId	String	A unique identifier for an event across calendars. This ID is different for each occurrence in a recurring series. Read-only.
id	String	Unique identifier for the event. !INCLUDE [outlook-beta-id] Case-sensitive and read-only.
importance	String	The importance of the event. The possible values are: `low`, `normal`, `high`.
isAllDay	Boolean	Set to true if the event lasts all day. If true, regardless of whether it's a single-day or multi-day event, start, and endtime must be set to midnight and be in the same time zone.
isCancelled	Boolean	Set to true if the event has been canceled.
isDraft	Boolean	Set to true if the user has updated the meeting in Outlook but hasn't sent the updates to attendees. Set to false if all changes are sent, or if the event is an appointment without any attendees.
isOnlineMeeting	Boolean	`True` if this event has online meeting information (that is, onlineMeeting points to an onlineMeetingInfo resource), `false` otherwise. Default is `false` (onlineMeeting is `null`). Optional. After you set isOnlineMeeting to `true`, Microsoft Graph initializes onlineMeeting. Subsequently, Outlook ignores any further changes to isOnlineMeeting, and the meeting remains available online.
isOrganizer	Boolean	Set to true if the calendar owner (specified by the owner property of the calendar) is the organizer of the event (specified by the organizer property of the event). It also applies if a delegate organized the event on behalf of the owner.
isReminderOn	Boolean	Set to true if an alert is set to remind the user of the event.
lastModifiedDateTime	DateTimeOffset	The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
location	Location	The location of the event.
locations	Location collection	The locations where the event is held or attended from. The location and locations properties always correspond with each other. If you update the location property, any prior locations in the locations collection are removed and replaced by the new location value.
onlineMeeting	OnlineMeetingInfo	Details for an attendee to join the meeting online. The default is null. Read-only. After you set the isOnlineMeeting and onlineMeetingProvider properties to enable a meeting online, Microsoft Graph initializes onlineMeeting. When set, the meeting remains available online, and you can't change the isOnlineMeeting, onlineMeetingProvider, and onlneMeeting properties again.
onlineMeetingProvider	onlineMeetingProviderType	Represents the online meeting service provider. By default, onlineMeetingProvider is `unknown`. The possible values are `unknown`, `teamsForBusiness`, `skypeForBusiness`, and `skypeForConsumer`. Optional. After you set onlineMeetingProvider, Microsoft Graph initializes onlineMeeting. Subsequently, you can't change onlineMeetingProvider again, and the meeting remains available online.
onlineMeetingUrl	String	A URL for an online meeting. The property is set only when an organizer specifies in Outlook that an event is an online meeting such as Skype. Read-only. To access the URL to join an online meeting, use joinUrl which is exposed via the onlineMeeting property of the event. The onlineMeetingUrl property will be deprecated in the future.
organizer	Recipient	The organizer of the event.
originalEndTimeZone	String	The end time zone that was set when the event was created. A value of `tzone://Microsoft/Custom` indicates that a legacy custom time zone was set in desktop Outlook.
originalStart	DateTimeOffset	Represents the start time of an event when it's initially created as an occurrence or exception in a recurring series. This property is not returned for events that are single instances. Its date and time information is expressed in ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
originalStartTimeZone	String	The start time zone that was set when the event was created. A value of `tzone://Microsoft/Custom` indicates that a legacy custom time zone was set in desktop Outlook.
recurrence	PatternedRecurrence	The recurrence pattern for the event.
reminderMinutesBeforeStart	Int32	The number of minutes before the event start time that the reminder alert occurs.
responseRequested	Boolean	Default is true, which represents the organizer would like an invitee to send a response to the event.
responseStatus	ResponseStatus	Indicates the type of response sent in response to an event message.
sensitivity	String	The possible values are: `normal`, `personal`, `private`, and `confidential`.
seriesMasterId	String	The ID for the recurring series master item, if this event is part of a recurring series.
showAs	String	The status to show. The possible values are: `free`, `tentative`, `busy`, `oof`, `workingElsewhere`, `unknown`.
start	DateTimeTimeZone	The start date, time, and time zone of the event. By default, the start time is in UTC.
subject	String	The text of the event's subject line.
transactionId	String	A custom identifier specified by a client app for the server to avoid redundant POST operations in case of client retries to create the same event. It's useful when low network connectivity causes the client to time out before receiving a response from the server for the client's prior create-event request. After you set transactionId when creating an event, you can't change transactionId in a subsequent update. This property is only returned in a response payload if an app has set it. Optional.
type	String	The event type. The possible values are: `singleInstance`, `occurrence`, `exception`, `seriesMaster`. Read-only
webLink	String	The URL to open the event in Outlook on the web. Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in. This URL can't be accessed from within an iFrame.

Graph reference: mailboxFolder

Property	Type	Description
childFolderCount	Int32	The number of immediate child folders in the current folder.
displayName	String	The display name of the folder.
id	String	The unique identifier for the folder.
parentFolderId	String	The unique identifier for the parent folder of this folder.
totalItemCount	Int32	The number of items in the folder.
type	String	Describes the folder class type.

Graph reference: mailboxItem

Property	Type	Description
categories	String collection	The categories associated with the message. Inherited from outlookItem.
changeKey	String	The version of the item. Inherited from outlookItem.
createdDateTime	DateTimeOffset	The date and time when the item was created. The date and time information uses ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`. Inherited from outlookItem.
id	String	The unique identifier for the item. Inherited from outlookItem.
lastModifiedDateTime	DateTimeOffset	The date and time when the item was last changed. The date and time information uses ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`. Inherited from outlookItem.
size	Int64	The length of the item in bytes.
type	String	The message class ID of the item.

Graph reference: mailFolder

Property	Type	Description
childFolderCount	Int32	The number of immediate child mailFolders in the current mailFolder.
displayName	String	The mailFolder's display name.
id	String	The mailFolder's unique identifier.
isHidden	Boolean	Indicates whether the mailFolder is hidden. This property can be set only when creating the folder. Find more information in Hidden mail folders.
parentFolderId	String	The unique identifier for the mailFolder's parent mailFolder.
totalItemCount	Int32	The number of items in the mailFolder.
unreadItemCount	Int32	The number of items in the mailFolder marked as unread.

Graph reference: message

Property	Type	Description
bccRecipients	recipient collection	The Bcc: recipients for the message.
body	itemBody	The body of the message. It can be in HTML or text format. Find out about safe HTML in a message body.
bodyPreview	String	The first 255 characters of the message body. It is in text format.
ccRecipients	recipient collection	The Cc: recipients for the message.
changeKey	String	The version of the message.
conversationId	String	The ID of the conversation the email belongs to.
conversationIndex	Edm.Binary	Indicates the position of the message within the conversation.
createdDateTime	DateTimeOffset	The date and time the message was created. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
flag	followupFlag	Indicates the status, start date, due date, or completion date for the message.
from	recipient	The owner of the mailbox from which the message is sent. In most cases, this value is the same as the sender property, except for sharing or delegation scenarios. The value must correspond to the actual mailbox used. Find out more about setting the from and sender properties of a message.
hasAttachments	Boolean	Indicates whether the message has attachments. This property doesn't include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a `src` attribute, such as `<IMG src="cid:[email protected]">`.
id	String	Unique identifier for the message. !INCLUDE [outlook-beta-id] Read-only.
importance	importance	The importance of the message. The possible values are: `low`, `normal`, and `high`.
inferenceClassification	inferenceClassificationType	The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. The possible values are: `focused` or `other`.
internetMessageHeaders	internetMessageHeader collection	A collection of message headers defined by RFC5322. The set includes message headers indicating the network path taken by a message from the sender to the recipient. It can also contain custom message headers that hold app data for the message. Requires `$select` to retrieve. Read-only.
internetMessageId	String	The message ID in the format specified by RFC2822.
isDeliveryReceiptRequested	Boolean	Indicates whether a read receipt is requested for the message.
isDraft	Boolean	Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet.
isRead	Boolean	Indicates whether the message has been read.
isReadReceiptRequested	Boolean	Indicates whether a read receipt is requested for the message.
lastModifiedDateTime	DateTimeOffset	The date and time the message was last changed. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
parentFolderId	String	The unique identifier for the message's parent mailFolder.
receivedDateTime	DateTimeOffset	The date and time the message was received. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
replyTo	recipient collection	The email addresses to use when replying.
sender	recipient	The account that is used to generate the message. In most cases, this value is the same as the from property. You can set this property to a different value when sending a message from a shared mailbox, for a shared calendar, or as a delegate. In any case, the value must correspond to the actual mailbox used. Find out more about setting the from and sender properties of a message.
sentDateTime	DateTimeOffset	The date and time the message was sent. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
subject	String	The subject of the message.
toRecipients	recipient collection	The To: recipients for the message.
uniqueBody	itemBody	The part of the body of the message that is unique to the current message. uniqueBody is not returned by default but can be retrieved for a given message by use of the `?$select=uniqueBody` query. It can be in HTML or text format.
webLink	String	The URL to open the message in Outlook on the web. You can append an `ispopout` argument to the end of the URL to change how the message is displayed. If `ispopout` is not present or if it is set to `1`, then the message is shown in a popout window. If `ispopout` is set to `0`, the browser shows the message in the Outlook on the web review pane. The message opens in the browser if you are signed in to your mailbox via Outlook on the web. You are prompted to sign in if you are not already signed in with the browser. This URL cannot be accessed from within an iFrame. **N

Property	Type	Description
id	string	The property identifier. Read-only.
value	string collection	A collection of property values.

Graph reference: note

Property	Type	Description
body	itemBody	The content of the note. Supports `text` or `html` content types.
bodyPreview	String	Auto-generated preview of the note body content (first ~255 characters, plain text). Read-only.
categories	String collection	The categories associated with the note. Inherited from outlookItem.
changeKey	String	Version identifier used for optimistic concurrency control via the `If-Match` header. Read-only. Inherited from outlookItem.
createdDateTime	DateTimeOffset	The date and time when the note was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is `2024-01-01T00:00:00Z`. Supports `$filter` (`eq`, `ge`, `le`, `gt`, `lt`). Read-only. Inherited from outlookItem.
hasAttachments	Boolean	Indicates whether the note has file attachments. Supports `$filter` (`eq`). Read-only.
id	String	The unique identifier for the note. Read-only. Inherited from outlookItem.
isDeleted	Boolean	Indicates whether the note is soft-deleted. Read-only.
lastModifiedDateTime	DateTimeOffset	The date and time when the note was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is `2024-01-01T00:00:00Z`. Supports `$filter` (`eq`, `ge`, `le`, `gt`, `lt`) and `$orderby`. Read-only. Inherited from outlookItem.
subject	String	The title of the note. Supports `$filter` (`eq`, `ne`, `startsWith`) and `$orderby`.

Graph reference: outlooktask

Property	Type	Description
assignedTo	String	The name of the person who has been assigned the task in Outlook. Read-only.
body	itemBody	The task body that typically contains information about the task. Only the HTML type is supported.
categories	String collection	The categories associated with the task. Each category corresponds to the displayName property of an outlookCategory that the user has defined.
changeKey	String	The version of the task.
completedDateTime	dateTimeTimeZone	The date in the specified time zone that the task was finished.
createdDateTime	DateTimeOffset	The date and time when the task was created. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
dueDateTime	dateTimeTimeZone	The date in the specified time zone that the task is to be finished.
hasAttachments	Boolean	Set to true if the task has attachments.
id	String	Unique identifier for the task. !INCLUDE [outlook-beta-id] Read-only.
importance	importance	The importance of the event. The possible values are: `low`, `normal`, `high`.
isReminderOn	Boolean	Set to true if an alert is set to remind the user of the task.
lastModifiedDateTime	DateTimeOffset	The date and time when the task was last modified. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
owner	String	The name of the person who created the task.
parentFolderId	String	The unique identifier for the task's parent folder.
recurrence	patternedRecurrence	The recurrence pattern for the task.
reminderDateTime	dateTimeTimeZone	The date and time for a reminder alert of the task to occur.
sensitivity	sensitivity	Indicates the level of privacy for the task. The possible values are: `normal`, `personal`, `private`, `confidential`.
startDateTime	dateTimeTimeZone	The date in the specified time zone when the task is to begin.
status	taskStatus	Indicates the state or progress of the task. The possible values are: `notStarted`, `inProgress`, `completed`, `waitingOnOthers`, `deferred`.
subject	String	A brief description or title of the task.

Graph reference: outlooktaskfolder

Property	Type	Description
changeKey	String	The version of the task folder.
id	String	The identifier of the task folder, unique in the user's mailbox. Read-only.
isDefaultFolder	Boolean	True if the folder is the default task folder.
name	String	The name of the task folder.
parentGroupKey	Guid	The unique GUID identifier for the task folder's parent group.

Graph reference: post

Property	Type	Description
body	itemBody	The contents of the post. This is a default property. This property can be null.
categories	String collection	The categories associated with the post.
changeKey	String	Identifies the version of the post. Every time the post is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
conversationId	String	Unique ID of the conversation. Read-only.
conversationThreadId	String	Unique ID of the conversation thread. Read-only.
createdDateTime	DateTimeOffset	Specifies when the post was created. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
from	recipient	Used in delegate access scenarios. Indicates who posted the message on behalf of another user. This is a default property.
hasAttachments	Boolean	Indicates whether the post has at least one attachment. This is a default property.
id	String	Read-only.
lastModifiedDateTime	DateTimeOffset	Specifies when the post was last modified. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
newParticipants	recipient collection	Conversation participants that were added to the thread as part of this post.
receivedDateTime	DateTimeOffset	Specifies when the post was received. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
sender	recipient	Contains the address of the sender. The value of Sender is assumed to be the address of the authenticated user in the case when Sender is not specified. This is a default property.

Property	Type	Description
id	string	The property ID used to identify the property. Read-only.
value	string	A property value.

Graph reference: todoTask

Property	Type	Description
body	itemBody	The task body that typically contains information about the task.
bodyLastModifiedDateTime	DateTimeOffset	The date and time when the task body was last modified. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.
categories	String collection	The categories associated with the task. Each category corresponds to the displayName property of an outlookCategory that the user has defined.
completedDateTime	dateTimeTimeZone	The date and time in the specified time zone that the task was finished.
createdDateTime	DateTimeOffset	The date and time when the task was created. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.
dueDateTime	dateTimeTimeZone	The date and time in the specified time zone that the task is to be finished.
hasAttachments	Boolean	Indicates whether the task has attachments.
id	String	Unique identifier for the task. By default, this value changes when the item is moved from one list to another.
importance	importance	The importance of the task. The possible values are: `low`, `normal`, `high`.
isReminderOn	Boolean	Set to true if an alert is set to remind the user of the task.
lastModifiedDateTime	DateTimeOffset	The date and time when the task was last modified. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.
recurrence	patternedRecurrence	The recurrence pattern for the task.
reminderDateTime	dateTimeTimeZone	The date and time in the specified time zone for a reminder alert of the task to occur.
startDateTime	dateTimeTimeZone	The date and time in the specified time zone at which the task is scheduled to start.
status	taskStatus	Indicates the state or progress of the task. The possible values are: `notStarted`, `inProgress`, `completed`, `waitingOnOthers`, `deferred`.
title	String	A brief description of the task.

Graph reference: todoTaskList

Property	Type	Description
displayName	String	The name of the task list.
id	String	The identifier of the task list, unique in the user's mailbox. Read-only. Inherited from entity
isOwner	Boolean	True if the user is owner of the given task list.
isShared	Boolean	True if the task list is shared with other users
wellknownListName	wellknownListName	Property indicating the list name if the given list is a well-known list. The possible values are: `none`, `defaultList`, `flaggedEmails`, `unknownFutureValue`.

Table of Contents

MailboxFolder.Read.All

Graph Methods

Resources