Skip to main content

Task Office365 - Add Calendar Event​

The Office365 - Add calendar event(s) Task adds an event, or a recurring series, to a calendar of a Microsoft 365 user, using an Office365 Connection.

Office365 - Add calendar event(s) tab with the Connection, Event parameters and Event recurrence groups

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

Office365 - Add 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

Event parameters​

  • Calendar name: A calendar to check before the event is added, matched exactly. If the named calendar cannot be edited, the event is not added. The event is created in the user's default calendar
  • Event start date/time: When the event starts, in the Server computer's time zone. Required unless Is all day is selected. A value that cannot be read as a date makes the event start at the next full hour
  • Event end date/time: When the event ends, in the Server computer's time zone. Required unless Is all day is selected. A value that cannot be read as a date makes the event end two full hours after the hour the Task runs
  • Is all day: When selected, the event is an all-day event on the day the Task runs; the start and end values are not used
  • Event subject: The subject of the event. Required
  • Event location: The name of the location. Text after a ; is read as the location's e-mail address and address, so do not use ; in a plain location name
  • Reminder minutes: The number of minutes before the start that the reminder appears. A value that is not a whole number is ignored
  • Importance: "Low", "Normal" or "High". With none selected, the importance is not set
  • Event body: The text of the event, sent as plain text
  • Response requested: Selected or cleared sets whether responses are requested; the indeterminate state leaves it unset

Variables are resolved in the text and date fields.

Event recurrence​

  • 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: Empty for a single event, or "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 is "Success:" followed by the ID of the new 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.