Skip to main content

Task Office365 - Update Calendar Event​

The Office365 - Update calendar event(s) Task changes events in the calendars of a Microsoft 365 user, using an Office365 Connection.

Office365 - Update calendar event(s) tab with the Selected calendar event, Event parameters and Recurrence groups

warning

Calendar name and Event subject are patterns, and the Task acts on every event that matches. With Calendar name empty, the Task searches every calendar the user can edit. An Event subject of * matches every event it finds. Check the values with the Get calendar event(s) Task first.

The Main settings, Flow, On error, Conditions and TimeOut tabs are the same for every Task; see Job - Tasks.

Office365 - Update calendar event(s) tab​

Connection​

  • Connection: The Office365 Connection to use. The Task works on the calendars of the Microsoft 365 user the Connection signs in as. Click the Settings icon to open Manage Connections

Selected calendar event​

The event or events to change:

  • Calendar name: The name of the calendar, or a pattern: * matches any characters, ? one character, # one digit, and [ starts a character list. The match is not case-sensitive. Empty: every calendar the user can edit. A matching calendar the user cannot edit is skipped
  • Event subject: The subject of the event, or a pattern with the same characters as Calendar name. A subject that contains # or [ is read as a pattern and can match other events. A [ with no closing ] stops the Task with an error, possibly after some events were already processed. The match is not case-sensitive. Required
  • Event instance with date: When selected, only the occurrence of a recurring event on the date entered in the field next to it is changed; the rest of the series stays. When cleared, a recurring event is changed for the whole series

The Task checks only the first page of calendars, and the first page of events in each calendar, that Microsoft 365 returns, so a matching event that is not on those pages is not found.

Event parameters​

The new values. A field left empty keeps the event's current value.

  • Event start date/time: The new start, in the Server computer's time zone
  • Event end date/time: The new end, in the Server computer's time zone
  • Is all day: Selected makes the event an all-day event on the day the Task runs, and the start and end values are not used; cleared makes it a timed event; the indeterminate state leaves it unchanged
  • Event subject: The new subject
  • Event location: The new location name. Text after a ; is read as the location's e-mail address and address
  • Reminder minutes: The new reminder time, in minutes. A value that is not a whole number is ignored
  • Importance: "Low", "Normal" or "High". With none selected, the importance is unchanged
  • Event body: The new text, sent as plain text
  • Response requested: Selected or cleared sets whether responses are requested; the indeterminate state leaves it unchanged

Variables are resolved in the text and date fields.

Recurrence​

Applies to single events and whole series, not to a single occurrence.

warning

With Type empty, a recurring event that is updated as a whole series loses its recurrence and becomes a single event. To keep a series, set Type and the range again, or select Event instance with date to change one occurrence.

  • Range start date/time: The first date of the series. Empty: the day the Task runs
  • Range end date/time: The last date of the series. Used only when Range start date/time is set. Empty: the series has no end
  • Type: "Daily", "Weekly", "Monthly" or "Yearly". The controls next to it change with the type:
    • "Daily": Every with a number of days, from "1" to "5", or Every workday, Monday to Friday
    • "Weekly": Interval every "1" to "5" weeks, and the days of the week
    • "Monthly": Interval every "1" to "5" months, and either Day with the day of the month, or Every with the week, "First" to "Last", and the day of the week
    • "Yearly": Interval every "1" to "5" years, Month, and either Day with the day of the month, or Every with the week and the day of the week

Output and errors​

The output has a line for each updated event.

warning

If Microsoft 365 rejects the request, or a calendar cannot be read, the error is written to standard error, and the Task reports success.