Skip to main content
Skip table of contents

Microsoft Office 365

Microsoft Office 365 setup

Microsoft Office 365 uses OAuth 2.0. To use the Microsoft Office 365 connector, sign up for an application with Microsoft first and get the following authentication values:

  • OAuth client ID.

  • Client secret.

Create an Azure Active Directory OAuth application

For more information, see the official documentation for creating an Azure Active Directory application.

To summarize the above documentation:

  1. Either log into your existing Azure account or register for a free Azure account.

  2. In your Microsoft Azure portal, go to Azure Active Directory > App Registrations > New application registration.

  3. Provide the following details:

  • Name: Your Application Name

  • Reply URLs: Add a callback URL to allow Microsoft Office 365 to be used in your Cyclr Console and its Cyclr Accounts. The URL is https://{{Your Cyclr Service Domain e.g.}}/connector/callback.

  • Multi-tenanted: Yes

  1. Set the appropriate permissions.

Note: Ensure the refresh token expiry time is over 30 days as the OAuth authentication refreshes automatically every 29 days.

Set permissions

You need to set different permissions in Azure Active Directory depending on which methods you want to use. You also need to set the Type of each Permission differently depending on which Connector you use:

  • Microsoft Office 365 Connector: set permissions as Delegated.

  • Microsoft Office 365 (Application Permissions): set permissions as Application.

From the Application view, under Manage on the left side of the page, navigate to API Permissions. Add the following permissions:

Method Category

Permission Name






Calendars/Calendar Groups/Events















Note: For each permission, the type is either Delegated or Application dependent on the connector you use. For more information, see the Microsoft documentation on permissions.

Cyclr setup

To set up the Microsoft Office 365 connector in Cyclr, go to your Cyclr console:

  1. Go to Connectors > Application Connector Library.

  2. Use the search box to find the Microsoft Office 365 connector.

  3. Select the Setup Required icon.

  4. Enter the below values:



Client ID

The Application ID from your Microsoft Azure portal.

Client Secret

The password from your Microsoft Azure portal.

  1. Select Save Changes.

Note: If you leave any values blank, Cyclr asks for the value when you install the connector into an account. This means you can use different settings for different accounts.

Account setup

Depending on which version of the Microsoft Office 365 Connector you’re installing, there are different options:

Microsoft Office 365

When installing the Microsoft Office 365 Connector (not the “Application Permissions” version), you’ll see two authorization options:

  • Common: the connector allows you to use work or organization accounts, and personal Microsoft accounts, during authentication.

  • Organization: the connector only allows you to use work or organization accounts during authentication.

Microsoft Office 365 (Application Permissions)

When installing the Microsoft Office 365 (Application Permissions) Connector you’ll need the Tenant ID of the Microsoft account to work against.

The Tenant ID can be located as follows:

  1. sign in to the account’s Microsoft Entra admin center (formerly Azure Active Directory):

  2. on the left side, go to Identity > Overview.

  3. Scroll down to Tenant ID.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.