Docs / Workflows / Integrations / Outlook Calendar
Outlook Calendar
Read Outlook calendars and availability, manage meetings and answer invitations.
What you can do
Each Outlook Calendar integration’s page in OAIZ shows these uses, with its events and its read and write actions, under What you can do with Outlook Calendar.
- Invitations
- Accept or decline invitations by your own rules.
- Bookings
- Create an event when a customer books a call.
- Free times
- Find a time when everyone is free before proposing a meeting.
Connection scope
A connection reaches the Microsoft account’s calendars. Calendar and event IDs come from discovery actions. A recurring series has a master and individual occurrences. targetLevel identifies whether a write applies to one event, an occurrence or a series.
Connecting
Choose Outlook Calendar in OAIZ and authorize the Microsoft account the workflows should use. If this service is being added to an existing Microsoft connection, use the same account.
This service requests Calendars.Read and Calendars.ReadWrite to read and change the connected user’s own calendars. Every Microsoft connection also requests openid, profile, email, offline_access and User.Read for account identity and renewal. Enabling another Microsoft service adds that service’s permissions to the shared connection.
Read actions
- List Calendars
- List the connected user’s own calendars with IDs, edit rights and supported online-meeting providers.
- List Events
- Read event occurrences within a time window of up to 93 days. Recurring series are expanded into occurrences and exceptions.
- Get Event
- Read an event’s metadata, attendees and recurrence rule. The result excludes the event body.
- List Event Instances
- Read the occurrences and exceptions of a recurring series within a window of up to 93 days.
- Get Free/Busy
- Check availability for 1 to 20 people, groups or rooms over less than 62 days. This requires a work or school account.
Write actions
- Create Event
- Create a timed, all-day or recurring event. Microsoft sends invitations to its attendees.
- Update Event
- Change an event organized by the connected user. Microsoft sends meeting updates to attendees.
- Cancel Event
- Cancel a meeting organized by the connected user, with an optional cancellation message to attendees.
- Delete Event
- Delete an event from the connected calendar. Deleting an organized meeting sends attendee cancellations.
- Respond To Event
- Accept, tentatively accept or decline an invitation, for one event, occurrence or series.
Events
Supported calendar changes publish event records. Those records identify the changed item for a later read.
Write behaviour
An outcome_unknown result means OAIZ does not confirm whether Microsoft applied the meeting change. Read the current event before repeating it. Meeting writes can email attendees even when the next workflow step fails.