Read Event

Read event information from an authorized user or for another user's calendar in Office 365 Calendar using Event ID.

Options

Field Definition Type Required
Calendar

Choose the calendar type:

My Calendars: calendars owned by a connected user.

User Calendars: user calendar shared or delegated with a connected user.

Dropdown TRUE

Input

Field Definition Type Required
Read From
Calendar Choose a calendar from the list.

Appears when My Calendars is selected from the Calendar option.

Dropdown TRUE
User ID or Username: Unique ID of the user or username.

Appears when User Calendars is selected from the Calendar option.

String TRUE
Calendar ID Unique ID of the calendar.

Appears when User Calendars is selected from the Calendar option.

String TRUE
Read By      
Event ID Unique ID of the event. String TRUE

Output

Field Definition Type
Result    
Created Date and time information the event was created using ISO 8601 format and is always in UTC time.

For example, midnight UTC on Jan 1, 2014 is 2014-01-18T16:06:59.8274625Z

Date and Time
Last Modified Date and time information the event was modified using ISO 8601 format and is always in UTC time.

For example, midnight UTC on Jan 1, 2014 is 2014-01-18T16:06:59.8274625Z

Date and Time
Categories Categories associated with the event. List of String
Original Start Time Zone Represents the time zone used during event creation.

For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

String
Original End Time Zone Represents the time zone used during event completion. String
iCalUId Unique identifier for an event across calendars. This ID is different for each occurrence in a recurring series. String
Reminder Minutes Before Start Number of minutes before the event start time that the reminder alert occurs. Number
Is Reminder On? True if an alert is set to remind the user of the event; otherwise False. Boolean
Has Attachments? True if the event has attachments; otherwise False. Boolean
Subject Text of the event's subject line. String
Body Preview The preview of the message associated with the event. String
Importance Indicates the importance of the event. Possible values are:
  • Low

  • Normal

  • High

String
Sensitivity Indicates the sensitivity of the event. Possible values are:
  • Normal

  • Personal

  • Private

  • Confidential

String
Is All Day? True if the event lasts all day; otherwise, False. If true, regardless of whether it's a single-day or multi-day event, start and end time must be set to midnight and be in the same time zone. Boolean
Is Cancelled? True if the event has been canceled; otherwise False. Boolean
Is Organizer? True if the calendar owner is the organizer of the event; otherwise False. This also applies if a delegate organized the event on behalf of the owner. Boolean
Response Requested? True if the organizer would like an invitee to send a response to the event; otherwise False. Boolean
Show As Status to show. String
Type Event type. String
Web Link URL to open the event in Outlook on the web. Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in. String
Online Meeting URL URL for an online meeting. String
Is Online Meeting? True when this event has online meeting information. For example, an online meeting points to an online meeting info resource (phones). Otherwise False. Boolean
Online Meeting Provider Represents the online meeting service provider. String
Allow New Time Proposals? True when the meeting organizer allows invitees to propose a new time when responding; otherwise False. Boolean
Occurrence ID An identifier for an occurrence in a recurring event series. Null if the event is not part of a recurring series. String
Is Draft? True if the user has updated the meeting in Outlook but has not sent the updates to attendees; otherwise False. Boolean
Hide Attendees? True if each attendee only sees themselves in the meeting request and meeting Tracking list; otherwise False. Boolean
Response Status    
Response Response status from attendee. String
Time Date and time that the response was returned. It uses ISO 8601 format and is always in UTC time.

For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

Date and Time
Body    
Content Type Type of the body content. String
Content Unformatted content of the body of the event. String
Start    
Date Time Start of the event in a combined date and time representation ({date}T{time}.

For example, 2017-08-29T04:00:00.0000000.

Date and Time
Time Zone Represents a time zone.

For example, Pacific Standard Time.

String
End    
Date Time End of the event in a combined date and time representation ({date}T{time}.

For example, 2017-08-29T04:00:00.0000000.

Date and Time
Time Zone Represents a time zone.

For example, Pacific Standard Time.

String
Location    
Display Name Name associated with the location. String
Location URI URI representing the location. String
Location Type Type of location. String
Unique ID Unique identifier of the event. String
Unique ID Type Unique identifier type of the location. String
Street Street address of the user's place of business. String
City City in which the event is located. String
State State of the event. String
Country or Region Country or region of the event. String
Postal Code Postal code of the location. The postal code is specific to the user's country or region. In the United States of America, this attribute contains the ZIP code. String
Latitude Latitude of the location. Number
Longitude Latitude of the location. Number
Locations    
Display Name Name associated with the location. String
Location URI URI representing the location. String
Location Type Type of location. String
Unique ID Unique identifier of the event. String
Unique ID Type Unique identifier type of the location. String
Street Street address of the user's place of business. String
City City in which the event is located. String
State State of the event.

Appears when multiple locations are returned.

String
Country or Region Country or region of the event. String
Postal Code Postal code of the location. The postal code is specific to the user's country or region. In the United States of America, this attribute contains the ZIP code. String
Latitude Latitude of the location. Number
Longitude Latitude of the location. Number
Recurrence    
Pattern Frequency of the event repeating. String
Type Recurrence pattern type. String
Interval Number of units between occurrences, where units can be in days, weeks, months, or years, depending on the type. Number
Month Month in which the event occurs. This is a number from 1 to 12. Number
Day of Month Day of the month on which the event occurs. String
First Day of Week The first day of the week. String
Index Specifies on which instance of the allowed days specified in days of week the event occurs, counted from the first instance in the month. String
Range    
Type Recurrence range. String
Start Date Date to start applying the recurrence pattern. The first occurrence of the meeting may be this date or later, depending on the recurrence pattern of the event. Must be the same value as the start property of the recurring event.

For example, YYYY-MM-DD

String
End Date Date to stop applying the recurrence pattern. Depending on the recurrence pattern of the event, the last occurrence of the meeting may not be this date.

For example, YYYY-MM-DD

String
Recurrence Time Zone Time zone for the Start Date and End Date properties. String
Number of Occurrences Number of times to repeat the event. Required and must be positive if type is numbered. Number
Attendees    
Type Attendee type. String
Status    
Response Response type. String
Time The date and time that the response was returned. It uses ISO 8601 format and is always in UTC time.

For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

Date and Time
Email Address    
Name Display name of the person or entity. String
Address Email address of the person or entity. String
Organizer    
Email Address Email address of owner of calendar. String
Name Name of organizer. String
Address Email address of the organizer. String
Online Meeting    
Conference ID ID of the conference. String
Join URL External link that launches the online meeting. This is a URL that clients will launch into a browser and will redirect the user to join the meeting. String
Phones All of the phone numbers associated with this conference. List of Objects
Number Phone number. String
Type Type of phone number. String
Quick Dial Pre-formatted quick dial for this call. String
Toll Free Number Toll free numbers that can be used to join the conference. List of Strings
Toll Number Toll number that can be used to join the conference. String

Additional information

  • You can specify the time zone for each of the start and end times of the event.

  • An Exchange administrator can set up a mailbox and an email address for a resource such as a meeting room, or equipment like a projector. Users can then invite the resource as an attendee to a meeting.

  • Location output fields are dependent upon the number of locations.
  • When organizing an event that involves a meeting location:
    • Set the location property of the event accordingly.
    • Set the optional location Email Address property if the meeting location has an email address.

Related topics

Office 365 Calendar connector

Elements of Workflows

Guidance for Office 365 Calendar connector

Microsoft Graph Rest API