> For the complete documentation index, see [llms.txt](https://docs.cubu.com/guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cubu.com/guides/technical-guide/advanced-configuration/calendar-integration/configuring-microsoft-office-365-calendar-integration.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.