Authorization

The Office 365 Calendar connector is authorized using Oauth2. When you add an Office 365 Calendar card to a flow for the first time, you'll be prompted to create a connection.

Tip

You can create multiple connections and manage them from your Connections page.

Prerequisites

  • Office 365 Calendar admin account

  • Office 365 Calendar Exchange admin credentials

  • The user account used to create the Workflows connection requires an Office 365 Calendar license

Procedure

To create a new connection:

  1. Click New Connection.

  2. Add a Connection Nickname. This is useful if you plan to create multiple connections to share with your team.

  3. Click Create.

  4. When the Oauth window appears, log in with your Microsoft administrator account and continue.

  5. Select Consent on behalf of your organization if you want to set permissions for all users in your org.

  6. Click Accept.

Calendars

To access another user's calendar, you must be designated a sharee of that user's calendar by the Exchange admin and have enabled the following scopes:

  • Calendars.ReadWrite

  • User.ReadWrite

  • Offline_access

Enable Mailbox Sharing

Exchange admins need to enable mailbox sharing for user who need access to Workflows calendar connector cards.

  1. Go to https://admin.exchange.microsoft.com/#/mailboxes.

  2. Click Manage mailbox delegation.

  3. Click Edit, next to the Read and manage.

  4. Click Add permissions.

  5. Add a user by typing the name or email address of the user in the box.

  6. Click Save.

Supported scopes

The Office 365 Admin connector supports application scopes in addition to All and Shared scopes from the Microsoft Graph API.

  • Calendar.ReadWrite

  • Calendars.ReadWrite.Shared
  • User.Read Place.Read.All
  • User.ReadBasic.All
  • Offline_access

See Microsoft Graph permissions reference.

Related topics

Office 365 Calendar connector

About the elements of Okta Workflows

Microsoft Graph Rest API