Mail.ReadWrite
Allows the app to create, read, update, and delete email in user mailboxes. Does not include permission to send mail.
Graph Methods
Type: A = Application Permission, D = Delegate Permission
Delegate Permission
Id | 024d486e-b451-40bb-833d-3e66d98c5c73 |
Consent Type | User |
Display String | Read and write access to user mail |
Description | Allows the app to create, read, update, and delete email in user mailboxes. Does not include permission to send mail. |
Application Permission
Id | e2a3a72e-5f79-4c64-b1b1-878b674786c9 |
Display String | Read and write mail in all mailboxes |
Description | Allows the app to create, read, update, and delete mail in all mailboxes without a signed-in user. Does not include permission to send mail. |
Resources
attachment
Property | Type | Description |
---|---|---|
contentType | String | The MIME type. |
id | String | Read-only. |
isInline | Boolean | true if the attachment is an inline attachment; otherwise, false . |
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 |
name | String | The attachment's file name. |
size | Int32 | The length of the attachment in bytes. |
eventMessage
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. |
bodyPreview | String | The first 255 characters of the message body. It is in text format. |
categories | String collection | The categories associated with the message. |
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. |
flag | followupFlag | The flag value that 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. |
id | String | Unique identifier for the event message. !INCLUDE [outlook-beta-id] Read-only. |
importance | String | The importance of the message: low , normal , high . |
inferenceClassification | String | The possible values are: focused , other . |
internetMessageHeaders | internetMessageHeader collection | The collection of message headers, defined by RFC5322, that provide details of the network path taken by a message from the sender to the recipient. Read-only. |
internetMessageId | String | The message ID in the format specified by RFC2822. |
isDelegated | Boolean | True if this meeting request is accessible to a delegate, false otherwise. Default is false. |
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. |
meetingMessageType | meetingMessageType | The type of event message: none , meetingRequest , meetingCancelled , meetingAccepted , meetingTenativelyAccepted , meetingDeclined . |
parentFolderId | String | The unique identifier for the message's parent mailFolder. |
receivedDateTime | DateTimeOffset | The date and time the message was received. |
replyTo | recipient collection | The email addresses to use when replying. |
sender | recipient | The account that is actually 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. |
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. |
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, then the browser will show the message in the Outlook on the web review pane. The message will open in the browser if you are logged in to your mailbox via Outlook on the web. You will be prompted to login if you are not already logged in with the browser. This URL cannot be accessed from within an iFrame. |
followupFlag
Property | Type | Description |
---|---|---|
completedDateTime | dateTimeTimeZone | The date and time that the follow-up was finished. |
dueDateTime | dateTimeTimeZone | The date and time that the follow-up is to be finished. Note: To set the due date, you must also specify the startDateTime ; otherwise, you get a 400 Bad Request response. |
flagStatus | followupFlagStatus | The status for follow-up for an item. Possible values are notFlagged , complete , and flagged . |
startDateTime | dateTimeTimeZone | The date and time that the follow-up is to begin. |
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. |
mailSearchFolder
Property | Type | Description |
---|---|---|
filterQuery | String | The OData query to filter the messages. |
includeNestedFolders | Boolean | Indicates how the mailbox folder hierarchy should be traversed in the search. true means that a deep search should be done to include child folders in the hierarchy of each folder explicitly specified in sourceFolderIds. false means a shallow search of only each of the folders explicitly specified in sourceFolderIds. |
isSupported | Boolean | Indicates whether a search folder is editable using REST APIs. |
sourceFolderIds | String collection | The mailbox folders that should be mined. |
mention
Property | Type | Description |
---|---|---|
application | String | The name of the application where the mention is created. Optional. Not used and defaulted as null for message. |
clientReference | String | A unique identifier that represents a parent of the resource instance. Optional. Not used and defaulted as null for message. |
createdBy | emailAddress | The email information of the user who made the mention. |
createdDateTime | DateTimeOffset | The date and time that the mention is created on the client. |
deepLink | String | A deep web link to the context of the mention in the resource instance. Optional. Not used and defaulted as null for message. |
id | String | The unique identifier of a mention in a resource instance. |
mentioned | emailAddress | The email information of the mentioned person. Required. |
mentionText | String | Optional. Not used and defaulted as null for message. To get the mentions in a message, see the bodyPreview property of the message instead. |
serverCreatedDateTime | DateTimeOffset | The date and time that the mention is created on the server. Optional. Not used and defaulted as null for **m |
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. |
categories | String collection | The categories associated with the message. |
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 | The flag value that 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. Returned only on applying a $select query option. 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 actually 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, then the browser will show the message in the Outlook on the web review pane. The message will open in the browser if you are logged in to your mailbox via Outlook on the web. You will be prompted to login if you are not already logged in with the browser. This URL cannot be accessed from within an iFrame. |
multiValueLegacyExtendedProperty
Property | Type | Description |
---|---|---|
id | string | The property identifier. Read-only. |
value | string collection | A collection of property values. |
singleValueLegacyExtendedProperty
Property | Type | Description |
---|---|---|
id | string | The property ID used to identify the property. Read-only. |
value | string | A property value. |