# Configuring Microsoft Office 365 Calendar Integration

{% hint style="info" %}
Following the instructions in this document requires admin access to the organization’s active directory.
{% endhint %}

Following the instructions in this document requires admin access to the organization’s active directory.

## Overview <a href="#overview" id="overview"></a>

For Cubu to access the Office 365 Calendars of users in your organization, you must provide Cubu with the proper credentials.

The process consists of the following steps:

1. Creating a **Registered** **App** in the organization’s active directory.
2. Creating a **client secret** (this allows Cubu to request access tokens).
3. Grant the app with **API access** privileges.
4. Configure Cubu to use the registered app for online meetings.

## Active Directory Configuration <a href="#active-directory-configuration" id="active-directory-configuration"></a>

### Creating a Registered App <a href="#creating-a-registered-app" id="creating-a-registered-app"></a>

In this step, you will create an application in your Azure Active Directory that clients can use to create Teams meetings on behalf of users.

* With an Azure account with Global Administrator privileges, log in to the Microsoft Azure portal.
* In the left navigation bar, click Azure Active Directory.
* Click App registrations.
* Click the New Registration button.
* Provide a name for the application, for example: “Cubu Calendars Integration”.

<figure><img src="/files/2tGQGQfmoAKq5cAvHM0H" alt=""><figcaption><p>Register an Application</p></figcaption></figure>

After the application is created, take note of the `Application (client) ID` and `Directory (tenant) Id` for later use.

<figure><img src="/files/Q0fqjjXjyTjUzf2tqVJ0" alt=""><figcaption><p>Registered Application</p></figcaption></figure>

### Creating a Client Secret <a href="#creating-a-client-secret" id="creating-a-client-secret"></a>

In this step, you will create a client secret for the application. Cubu will use the client’s secret and the client and tenant IDs to obtain an access token to Microsoft Graph API.

* Click on “Certificates and Secrets”.
* Click on “New client secret” and provide a name for your secret.
* After the secret is created, take note of the secret **value**.\
  **This value will no longer be available once you leave the page.**

{% hint style="warning" %}
It is a common mistake to copy the Secret ID instead of the Secret Value.\
Please make sure you use the **Secret Value**.
{% endhint %}

<figure><img src="/files/ZYOwIxzBpv3LGWgxjVw5" alt=""><figcaption><p>Client Secret</p></figcaption></figure>

### Granting API Permissions <a href="#granting-api-permissions" id="granting-api-permissions"></a>

In this step, you grant the application minimal access permissions to Microsoft Graph API.

* Click on “API Permissions”.
* Click on “Microsoft Graph”
* Make sure to choose **Application permissions**

<figure><img src="/files/pORALuJ02zlfp8p1QILm" alt=""><figcaption><p>Application Permissions</p></figcaption></figure>

* Add the following permissions:
  * Calendars.ReadWrite
  * User.ReadBasic.All

<figure><img src="/files/FnUMTw3ZUiQrzwUoVwIQ" alt=""><figcaption><p>API Permissions</p></figcaption></figure>

{% hint style="warning" %}
**Important!**\
If you intend to use this registered app to create Teams video meetings for **walk-ins**, add more permissions and configure an access policy.
{% endhint %}

## Cubu Configuration <a href="#cubu-configuration" id="cubu-configuration"></a>

* In Cubu, go to Admin Tools > Settings > Integration.
* Choose the Calendars tab.
* Select **Microsoft Office 365** as the provider type.
* Enter the `Tenant Id`, `Client Id,` and `Client Secret`
* Tick the `Enable external calendars integration` check box
* Click on Save


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cubu.com/guides/technical-guide/advanced-configuration/calendar-integration/configuring-microsoft-office-365-calendar-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.