Search documentation

Search for a topic, a control, or an event type.

    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.