Microsoft Outlook · Schema
Microsoft Outlook Message
JSON Schema for a Microsoft Graph message resource representing an email message in a user's mailbox. Based on the microsoft.graph.message resource type from the Microsoft Graph v1.0 API.
CalendarContactsEmailEnterpriseMicrosoftOffice 365Productivity
Properties
| Name | Type | Description |
|---|---|---|
| id | string | Unique identifier for the message. By default, this value changes when the item is moved from one container to another. Use the Prefer: IdType="ImmutableId" header for immutable identifiers. |
| createdDateTime | string | The date and time the message was created. Uses ISO 8601 format in UTC time (e.g., 2014-01-01T00:00:00Z). |
| lastModifiedDateTime | string | The date and time the message was last changed. Uses ISO 8601 format in UTC time. |
| changeKey | string | The version of the message. |
| categories | array | The categories associated with the message. |
| receivedDateTime | string | The date and time the message was received. Uses ISO 8601 format in UTC time. |
| sentDateTime | string | The date and time the message was sent. Uses ISO 8601 format in UTC time. |
| hasAttachments | boolean | Indicates whether the message has attachments. This property does not include inline attachments. To verify inline attachments, parse the body property for a src attribute. |
| internetMessageId | string | The message ID in the format specified by RFC 2822. |
| internetMessageHeaders | array | A collection of message headers defined by RFC 5322. Includes custom message headers starting with 'x-'. Returned only on applying a $select query option. |
| subject | string | The subject of the message. |
| body | object | The body of the message. Can be in HTML or text format. |
| bodyPreview | string | The first 255 characters of the message body in text format. |
| importance | string | The importance of the message. |
| parentFolderId | string | The unique identifier for the message's parent mailFolder. |
| conversationId | string | The ID of the conversation the email belongs to. |
| conversationIndex | string | Indicates the position of the message within the conversation. Binary value encoded as base64. |
| isDeliveryReceiptRequested | booleannull | Indicates whether a delivery receipt is requested for the message. |
| isReadReceiptRequested | boolean | Indicates whether a read receipt is requested for the message. |
| isRead | boolean | Indicates whether the message has been read. |
| isDraft | boolean | Indicates whether the message is a draft. A message is a draft if it has not been sent yet. |
| webLink | string | The URL to open the message in Outlook on the web. Append ispopout=0 to show in the review pane instead of a popout window. |
| inferenceClassification | string | The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. |
| flag | object | The follow-up flag value indicating the status, start date, due date, or completion date for the message. |
| from | object | The owner of the mailbox from which the message is sent. In most cases, this is the same as the sender property, except for sharing or delegation scenarios. |
| sender | object | The account that is used to generate the message. In most cases, this is the same as the from property. Can differ when sending from a shared mailbox or as a delegate. |
| toRecipients | array | The To: recipients for the message. |
| ccRecipients | array | The Cc: recipients for the message. |
| bccRecipients | array | The Bcc: recipients for the message. |
| replyTo | array | The email addresses to use when replying. |
| uniqueBody | object | The part of the body of the message that is unique to the current message. Not returned by default; use $select=uniqueBody. |
| attachments | array | The fileAttachment and itemAttachment attachments for the message. |