eventMessage resource type

A message that represents a meeting request, meeting cancel message, meeting accept message, meeting tentatively accept message, or meeting declined message.

An EventMessage is typically found in the Inbox folder where it arrives as the results of either an event organizer creating a meeting or by an attendee responding to a meeting request. You act on event messages in the same way that you act on Message, with some minor differences described in the following table.

Methods

Method Return Type Description
Get eventMessage eventMessage Read properties and relationships of eventMessage object.
Update eventMessage Update eventMessage object.
Delete None Delete eventMessage object.
copy Message Copy a message to a folder.
createForward Message Create a draft of the Forward message. You can then update or send the draft.
createReply Message Create a draft of the Reply message. You can then update or send the draft.
createReplyAll Message Create a draft of the Reply All message. You can then update or send the draft.
forward None Forward a message. The message is then saved in the Sent Items folder.
move Message Move a message to a folder. This creates a new copy of the message in the destination folder.
reply None Reply to the sender of a message. The message is then saved in the Sent Items folder.
replyAll None Reply to all recipients of a message. The message is then saved in the Sent Items folder.
send None Sends a previously created message draft. The message is then saved in the Sent Items folder.
Attachments
List attachments Attachment collection Get all attachments on an eventMessage.
Add attachment Attachment Add a new attachment to an eventMessage by posting to the attachments collection.
Data extensions
Create data extension openTypeExtension Create an open type data extension and add custom properties in a new or existing instance of a resource.
Get data extension openTypeExtension collection Get an openTypeExtension object or objects identified by name or fully qualified name.
Extended properties
Create single-value extended property eventMessage Create one or more single-value extended properties in a new or existing eventMessage.
Get eventMessage with single-value extended property eventMessage Get eventMessages that contain a single-value extended property by using $expand or $filter.
Create multi-value extended property eventMessage Create one or more multi-value extended properties in a new or existing eventMessage.
Get eventMessage with multi-value extended property eventMessage Get an eventMessage that contains a multi-value extended property by using $expand.

Properties

Property Type Description
bccRecipients recipient collection The Bcc: recipients for the message.
body itemBody The body of the message.
bodyPreview String The first 255 characters of the message body.
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.
createdDateTime DateTimeOffset The date and time the message was created.
from recipient The mailbox owner and sender of the message.
hasAttachments Boolean Indicates whether the message has attachments.
id String
importance String The importance of the message: Low, Normal, High.
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.
meetingMessageType String 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.
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 Web App.

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 Web App review pane.

The message will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

This URL can be accessed from within an iFrame.

Relationships

Relationship Type Description
attachments Attachment collection Read-only. Nullable.
event Event The event associated with the event message. The assumption for attendees or room resources is that the Calendar Attendant is set to automatically update the calendar with an event when meeting request event messages arrive. Navigation property. Read-only.
extensions Extension collection The collection of open type data extensions defined for the contact. Read-only. Nullable.
multiValueExtendedProperties multiValueLegacyExtendedProperty collection The collection of multi-value extended properties defined for the eventMessage. Read-only. Nullable.
singleValueExtendedProperties singleValueLegacyExtendedProperty collection The collection of single-value extended properties defined for the eventMessage. Read-only. Nullable.

JSON representation

Here is a JSON representation of the resource

{
  "bccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "changeKey": "string",
  "conversationId": "string",
  "createdDateTime": "String (timestamp)",
  "from": {"@odata.type": "microsoft.graph.recipient"},
  "hasAttachments": true,
  "id": "string (identifier)",
  "importance": "String",
  "internetMessageId": "String",
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "String (timestamp)",
  "meetingMessageType": "String",
  "parentFolderId": "string",
  "receivedDateTime": "String (timestamp)",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "String (timestamp)",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "webLink": "string"
}