eventMessageResponse resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

A message that represents a response to a meeting request in the meeting organizer's mailbox.

Derived from eventMessage.

An organizer who receives an eventMessageResponse with the responseType set to tentativelyAccepted or declined, and that includes a proposedNewTime property, can choose to accept the proposal. To do so, first, use the event navigation property of the eventMessageResponse to access the corresponding event, as shown in this example. Then update the associated event to the proposed time.

For more information on how to propose a time, and how to receive and accept a new time proposal, see Propose new meeting times.

Methods

Method Return Type Description
Get event message eventMessage Read properties and relationships of eventMessage object.
Update event message eventMessage Update eventMessage object.
Delete event message None Delete eventMessage object.
Copy message message Copy a message to a folder.
Create draft to forward message message Create a draft of the Forward message. You can then update or send the draft.
Create draft to reply message Create a draft of the Reply message. You can then update or send the draft.
Create draft to reply-all message Create a draft of the Reply All message. You can then update or send the draft.
Forward message None Forward a message. The message is then saved in the Sent Items folder.
Move message message Move a message to a folder. This creates a new copy of the message in the destination folder.
Reply to message None Reply to the sender of a message. The message is then saved in the Sent Items folder.
Reply-all to message None Reply to all recipients of a message. The message is then saved in the Sent Items folder.
Send draft message None Sends a previously created message draft. The message is then saved in the Sent Items folder.
Recall message message Recall a message in the specified user's mailbox Sent Items folder.
Unsubscribe None Send a message using the data and address specified in the first mailto command in the List-Unsubscribe header.
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.
Open extensions
Create open extension openTypeExtension Create an open extension and add custom properties in a new or existing instance of a resource.
Get open extension openTypeExtension collection Get an open extension identified by name.
Extended properties
Create single-value property eventMessage Create one or more single-value extended properties in a new or existing eventMessage.
Get single-value property eventMessage Get eventMessages that contain a single-value extended property by using $expand or $filter.
Create multi-value property eventMessage Create one or more multi-value extended properties in a new or existing eventMessage.
Get multi-value 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. 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 The Index of the conversation the email belongs to.
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
endDateTime dateTimeTimeZone The end time of the requested meeting.
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 message. By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. To change this behavior, use the Prefer: IdType="ImmutableId" header. See Get immutable identifiers for Outlook resources for more information. Read-only.
importance String The importance of the message: low, normal, high.
inferenceClassification String 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 RFC5322.
isAllDay Boolean Indicates whether the event lasts the entire day. Adjusting this property requires adjusting the startDateTime and endDateTime properties of the event as well.
isDelegated Boolean True if this meeting request response 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.
isOutOfDate Boolean Indicates whether this meeting request has been made out-of-date by a more recent request.
isRead Boolean Indicates whether the message has been read.
isReadReceiptRequested Boolean Indicates whether a read receipt is requested for the message.
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 requested meeting.
meetingMessageType String The type of event message: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTentativelyAccepted, meetingDeclined.
mentionsPreview mentionsPreview Information about mentions in the message. When processing a GET /messages request, the server sets this property and includes it in the response by default. The server returns null if there are no mentions in the message. Optional.
parentFolderId String The unique identifier for the message's parent mailFolder.
proposedNewTime timeSlot An alternate date/time proposed by an invitee for a meeting request to start and end. Read-only. Not filterable.
receivedDateTime 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
recurrence patternedRecurrence The recurrence pattern of the requested meeting.
replyTo recipient collection The email addresses to use when replying.
responseType string Specifies the type of response to a meeting request. Possible values are: tentativelyAccepted, accepted, declined. For the eventMessageResponse type, none, organizer, and notResponded are not supported. Read-only. Not filterable.
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 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
startDateTime dateTimeTimeZone The start time of the requested meeting.
subject String The subject of the message.
toRecipients recipient collection The To: recipients for the message.
type String The type of requested meeting: singleInstance, occurence, exception, seriesMaster.
uniqueBody itemBody The part of the body of the message that is unique to the current message.
UnsubscribeData String The valid entries parsed from the List-Unsubscribe header. This is the data for the mail command in the List-Unsubscribe header if UnsubscribeEnabled property is true.
UnsubscribeEnabled Boolean Indicates whether the message is enabled for unsubscribe. Its valueTrue if the list-Unsubscribe header conforms to rfc-2369.
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 isn't present or if it's set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser shows the message in the Outlook on the web review pane.

The message opens in the browser if you're logged in to your mailbox via Outlook on the web. You are prompted to login if you aren't already logged in with the browser.

This URL can't be accessed from within an iFrame.

Relationships

Relationship Type Description
attachments attachment collection The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the message. 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 extensions defined for the eventMessage. Read-only. Nullable.
mentions mention collection A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages doesn't return this property unless you apply $expand on the property.
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

The following JSON representation shows the resource type.

{
  "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",
  "conversationIndex": "String (binary)",
  "createdDateTime": "String (timestamp)",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "from": {"@odata.type": "microsoft.graph.recipient"},
  "hasAttachments": true,
  "id": "String (identifier)",
  "importance": "string",
  "inferenceClassification": "string",
  "internetMessageHeaders": [{"@odata.type": "microsoft.graph.internetMessageHeader"}],
  "internetMessageId": "String",
  "isAllDay": true,
  "isDelegated": true,
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isOutOfDate": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.location"},
  "meetingMessageType": "string",
  "mentionsPreview": {"@odata.type": "microsoft.graph.mentionsPreview"},
  "parentFolderId": "String",
  "proposedNewTime": {"@odata.type": "microsoft.graph.timeSlot"},
  "receivedDateTime": "String (timestamp)",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "responseType": "string",
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "String (timestamp)",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "String",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "type": "string",
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "unsubscribeData": ["String"],
  "unsubscribeEnabled": true,
  "webLink": "String"
}