Update Event

Update an existing event in Office 365 Calendar using an 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

Update Empty Fields?

Used to clear data from existing inputs. For example, to remove attendees or recurring events. Choose one of the following options:

  • Yes: Clear an existing input value with an empty field.
  • No: Update inputs.

True/False

TRUE

Input

Field Definition Type Required

Update In

Calendar

Choose a calendar.

Appears when you select My Calendars for the Calendar option.

Dropdown

TRUE

User ID or Username

Unique ID of the user or username.

Appears when you select User Calendars for the Calendar option.

Text

TRUE

Calendar ID

Unique ID of the calendar.

Appears when you select User Calendars for the Calendar option.

Text

TRUE
Update By

Event ID

Unique ID of the event.

Text

 TRUE
Event

Subject

Subject of the event.

Appears when you select Yes or No in the Update empty fields? option.

Text

FALSE

Body

Body of the message associated with the event. It can be in HTML or text format.

Appears when you select Yes or No in the Update empty fields? option.

Text

FALSE

Start

The date and time that was set when the event was created.

For example, YYYY-MM-DDTHH:MM:SS

This requires that the Start Time Zone field is defined.

Appears when you select No in the Update empty fields? option.

Date & Time

FALSE

Start Time Zone

Represents a time zone when the event was started.

For example, Pacific Standard Time.

Appears when you select No in the Update empty fields? option.

Text

FALSE

End

The date and time that was set when the event ended.

For example, YYYY-MM-DDTHH:MM:SS

Requires that the End Time Zone field is defined.

Appears when you select No in the Update empty fields? option.

Date & Time

FALSE

End Time Zone

Represents a time zone when the event ended.

For example, Pacific Standard Time.

Appears when you select My Calendars for the Calendar option.

Appears when you select No in the Update empty fields? option.

Text

FALSE

Required Attendees

Email addresses of attendees for the event.

Appears when you select Yes or No in the Update empty fields? option.

List of Text

FALSE

Optional Attendees

Optional email addresses of attendees for the event.

Appears when you select Yes or No in the Update empty fields? option.

List of Text

FALSE

Reminder Minutes Before Start

Number of minutes before the event start time that the reminder alert occurs.

Appears when you select Yes or No in the Update empty fields? option.

Number

FALSE

Is Reminder On?

True if an alert is set to remind the user of the event. Otherwise False.

Appears when you select Yes or No in the Update empty fields? option.

True/False

FALSE

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.

Appears when you select Yes or No in the Update empty fields? option.

True/False

FALSE

Response Requested?

True if a response to the event is required. Otherwise False.

Appears when you select Yes or No in the Update empty fields? option.

True/False

FALSE

Allow New Time Proposals?

True if the meeting organizer allows invitees to propose a new time when responding. Otherwise False.

Appears when you select Yes or No in the Update empty fields? option.

True/False

FALSE

Hide Attendees?

True if each attendee only sees themselves in the meeting request and meeting Tracking list. Otherwise False.

Appears when you select Yes or No in the Update empty fields? option.

True/False

FALSE

Importance

Indicates the importance of the event.

  • Low
  • Normal
  • High

Appears when you select No in the Update empty fields? option.

Dropdown

FALSE

Sensitivity

Indicates the sensitivity of the event.

  • Normal
  • Personal
  • Private
  • Confidential

Appears when you select No in the Update empty fields? option.

Dropdown

FALSE

Is Online Meeting?

True if this event has online meeting information. Otherwise False.

True/False

FALSE

Room IDs

Unique identifiers of rooms.

Identifiers are accepted from the Search Events card.

List of Text

FALSE

Recurrence Pattern

Recurrence

Recurrence Pattern appears when you select Yes from the Update empty fields? option.

Recurrence appears when you select No from the Update empty fields? option.

Pattern Type

Recurrence pattern type for the event. Choose a pattern type:

  • Daily: Event repeats based on the number of days specified by interval between occurrence.
  • Weekly: Event repeats on the same day or days of the week, based on the number of weeks between each set of occurrences.
  • Absolute Monthly: Event repeats on the specified day of the month (for example, the 15th), based on the number of months between occurrences.
  • Relative Monthly: Event repeats on the specified day or days of the week, in the same relative position in the month, based on the number of months between occurrences.
  • Absolute Yearly: Event repeats on the specified day and month, based on the number of years between occurrences.
  • Relative Yearly: Event repeats on the specified day or days of the week, in the same relative position in a specific month of the year, based on the number of years between occurrences.

Appears when you select Yes or No in the Update empty fields? option.

Dropdown

FALSE

Pattern Interval

Number of units between occurrences, where units can be in days, weeks, months, or years, depending on the type.

Appears when you select Yes or No in the Update empty fields? option.

Number

FALSE

Pattern Month

Month in which the event occurs. This is a number from 1 to 12.

Appears when you select Yes or No in the Update empty fields? option.

Number

FALSE

Pattern Day of Month

Day of the month on which the event occurs.

Required if Pattern Type is Absolute Monthly or Absolute Yearly.

Appears when you select Yes or No in the Update empty fields? option.

Number

FALSE

Pattern Days of Week

Day of the week on which the event occurs.

If type is Relative Monthly or Relative Yearly, and Days Of Week specifies more than one day, the event falls on the first day that satisfies the pattern.

Required if Pattern Type is, Weekly, Relative Monthly, or Relative Yearly.

Appears when you select Yes or No in the Update empty fields? option.

List of Text

FALSE

Pattern First Day of Week

First day of the week.

  • Sunday
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday

Required if Pattern Type is Weekly.

Appears when you select Yes or No in the Update empty fields? option.

Dropdown

FALSE

Pattern 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.

  • First
  • Second
  • Third
  • Fourth
  • Last

Required if Pattern Type is Relative Monthly or Relative Yearly.

Appears when you select Yes or No in the Update empty fields? option.

Dropdown

FALSE
Recurrence Range

Appears when Yes is selected from the Update empty fields? option.

Range Type

Recurrence range.

  • End Date
  • No End
  • Numbered

Appears when you select Yes or No in the Update empty fields? option.

Dropdown

FALSE

Range 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

Appears when you select Yes or No in the Update empty fields? option.

Date & Time

FALSE

Range 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. Required if Pattern Type is End Date.

For example, YYYY-MM-DD

Appears when you select Yes or No in the Update empty fields? option.

Date & Time

FALSE

Range Recurrence Time Zone

Time zone for the Start Date and End Date properties. Optional. If not specified, the time zone of the event is used.

Appears when you select Yes or No in the Update empty fields? option.

Text

FALSE

Range Number of Occurrences

Number of times to repeat the event.

Required if Range Type is Number.

Appears when you select Yes or No in the Update empty fields? option.

Number

FALSE

Output

Field Definition Type

Status Code

Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:

  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number

Additional Information

A 200 Updated status code indicates that the event was updated successfully.

To clear any of the following data fields, select Yes in the Update empty fields? option:

  • Subject: Clear the event subject

  • Body: Clear the event body

  • Required Attendees and Optional Attendees: Remove all attendees

  • Reminder Minutes Before Start: Remove reminder

  • Pattern Type: Remove the recurring events for the current parent event

    When events are removed from recurring events, the Recurrence Range Start Date is still available.

Related topics

Office 365 Calendar connector

Workflow elements

Guidance for Office 365 Calendar connector

Microsoft Graph Rest API