Message

A message in a mailFolder. Contains the message subject, body, sender, recipients, and other metadata.

CloudCollaborationEnterpriseMicrosoftProductivity

Properties

Name	Type	Description
id	string	Unique identifier for the message.
subject	string	The subject of the message.
body	object
bodyPreview	string	The first 255 characters of the message body in text format.
sender	object
from	object
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.
conversationId	string	The ID of the conversation the email belongs to.
conversationIndex	string	The index of the message in the conversation.
receivedDateTime	string	The date and time the message was received.
sentDateTime	string	The date and time the message was sent.
createdDateTime	string	The date and time the message was created.
lastModifiedDateTime	string	The date and time the message was last changed.
hasAttachments	boolean	Indicates whether the message has attachments.
internetMessageId	string	The message ID in RFC2822 format.
importance	string	The importance of the message.
isRead	boolean	Indicates whether the message has been read.
isDraft	boolean	Indicates whether the message is a draft.
isDeliveryReceiptRequested	boolean	Indicates whether a delivery receipt is requested.
isReadReceiptRequested	boolean	Indicates whether a read receipt is requested.
flag	object
categories	array	The categories associated with the message.
parentFolderId	string	The unique identifier for the message's parent mailFolder.
webLink	string	The URL to open the message in Outlook on the web.
inferenceClassification	string	The classification of the message based on inferred relevance.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Message",
  "title": "Message",
  "type": "object",
  "description": "A message in a mailFolder. Contains the message subject, body, sender, recipients, and other metadata.",
  "properties": {
    "id": {
      "type": "string",
      "readOnly": true,
      "description": "Unique identifier for the message.",
      "example": "abc123"
    },
    "subject": {
      "type": "string",
      "description": "The subject of the message.",
      "example": "example_value"
    },
    "body": {
      "$ref": "#/components/schemas/ItemBody"
    },
    "bodyPreview": {
      "type": "string",
      "readOnly": true,
      "description": "The first 255 characters of the message body in text format.",
      "example": "example_value"
    },
    "sender": {
      "$ref": "#/components/schemas/Recipient"
    },
    "from": {
      "$ref": "#/components/schemas/Recipient"
    },
    "toRecipients": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Recipient"
      },
      "description": "The To recipients for the message.",
      "example": []
    },
    "ccRecipients": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Recipient"
      },
      "description": "The Cc recipients for the message.",
      "example": []
    },
    "bccRecipients": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Recipient"
      },
      "description": "The Bcc recipients for the message.",
      "example": []
    },
    "replyTo": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Recipient"
      },
      "description": "The email addresses to use when replying.",
      "example": []
    },
    "conversationId": {
      "type": "string",
      "readOnly": true,
      "description": "The ID of the conversation the email belongs to.",
      "example": "500123"
    },
    "conversationIndex": {
      "type": "string",
      "format": "byte",
      "readOnly": true,
      "description": "The index of the message in the conversation.",
      "example": "example_value"
    },
    "receivedDateTime": {
      "type": "string",
      "format": "date-time",
      "readOnly": true,
      "description": "The date and time the message was received.",
      "example": "2026-01-15T10:30:00Z"
    },
    "sentDateTime": {
      "type": "string",
      "format": "date-time",
      "readOnly": true,
      "description": "The date and time the message was sent.",
      "example": "2026-01-15T10:30:00Z"
    },
    "createdDateTime": {
      "type": "string",
      "format": "date-time",
      "readOnly": true,
      "description": "The date and time the message was created.",
      "example": "2026-01-15T10:30:00Z"
    },
    "lastModifiedDateTime": {
      "type": "string",
      "format": "date-time",
      "readOnly": true,
      "description": "The date and time the message was last changed.",
      "example": "2026-01-15T10:30:00Z"
    },
    "hasAttachments": {
      "type": "boolean",
      "readOnly": true,
      "description": "Indicates whether the message has attachments.",
      "example": true
    },
    "internetMessageId": {
      "type": "string",
      "readOnly": true,
      "description": "The message ID in RFC2822 format.",
      "example": "500123"
    },
    "importance": {
      "type": "string",
      "enum": [
        "low",
        "normal",
        "high"
      ],
      "description": "The importance of the message.",
      "example": "low"
    },
    "isRead": {
      "type": "boolean",
      "description": "Indicates whether the message has been read.",
      "example": true
    },
    "isDraft": {
      "type": "boolean",
      "readOnly": true,
      "description": "Indicates whether the message is a draft.",
      "example": true
    },
    "isDeliveryReceiptRequested": {
      "type": "boolean",
      "description": "Indicates whether a delivery receipt is requested.",
      "example": true
    },
    "isReadReceiptRequested": {
      "type": "boolean",
      "description": "Indicates whether a read receipt is requested.",
      "example": true
    },
    "flag": {
      "$ref": "#/components/schemas/FollowupFlag"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The categories associated with the message.",
      "example": []
    },
    "parentFolderId": {
      "type": "string",
      "readOnly": true,
      "description": "The unique identifier for the message's parent mailFolder.",
      "example": "500123"
    },
    "webLink": {
      "type": "string",
      "format": "uri",
      "readOnly": true,
      "description": "The URL to open the message in Outlook on the web.",
      "example": "https://www.example.com"
    },
    "inferenceClassification": {
      "type": "string",
      "enum": [
        "focused",
        "other"
      ],
      "description": "The classification of the message based on inferred relevance.",
      "example": "focused"
    }
  }
}