> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/integrations/calendar/on-prem-outlook-integration.md).

# On-Prem Outlook Integration

To integrate Microsoft Outlook with Hivel and enable [<mark style="color:purple;">Meetings Breakdown insights</mark>](/using-hivel/cockpit/metrics-and-definitions/meetings-breakdown.md), you must have an admin Azure account. Follow the steps below to obtain the Tenant ID, Client ID, and Client Secret, which you will enter into your Hivel instance.

### How to Integrate Microsoft Outlook with Hivel

**Prerequisite:**

* You must have **admin access** to your Azure portal.

***

#### Step 1: Access Azure Portal

* Log in to [portal.azure.com](https://portal.azure.com) using your **admin Azure account**.

#### Step 2: Navigate to App Registrations

* In the Azure portal search bar, type **App Registrations** and open it.<br>

  <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FDtFdWjh9Luv4fr5I8Klg%2Fimage.png?alt=media&amp;token=0f95b0ea-f400-4b0a-b44d-57b2150f7d46" alt=""><figcaption></figcaption></figure>

#### Step 3: Create a New App Registration

* Click **New Registration**.
* Enter any **name** for your application.
* Set **Supported account types** to:\
  *“Accounts in any organizational directory (Any Microsoft Azure AD tenant - Multitenant)”*.
* Click **Register**.

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F3C8fFVlYIlHwVoV9bAOp%2Fimage.png?alt=media&amp;token=d42b0895-7536-4b89-b299-e6dc4ac3eacd" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FqimJ6pWtLbHgW2DLrho1%2Fimage.png?alt=media&amp;token=1b898677-92f0-4b80-8b32-144815efb2aa" alt="" width="375"><figcaption></figcaption></figure>

#### Step 4: Save Your IDs

* After registration, copy and save the following:
  * **Client ID** (Application ID)
  * **Directory (tenant) ID**

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F7qkD5JUzU3grLuvSaQC6%2Fimage.png?alt=media&amp;token=93981d16-b819-47b9-9191-c375e6711e41" alt="" width="379"><figcaption></figcaption></figure>

#### Step 5: Generate Client Secret

* In the left menu, click **Certificates & Secrets**.
* Click **New Client Secret**.
* Add a description and set an expiry period.
* Click **Add**.
* **Immediately copy the Secret Value** — you won’t be able to see it again later.

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FHhRi2Sz2u4YC7zQL0XTe%2Fimage.png?alt=media&amp;token=57b8f47d-f428-49f6-8b18-dda346aad513" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FVjZDVzHRE4OAJFddruta%2Fimage.png?alt=media&amp;token=4b40210f-5e30-411e-ba71-6ec94f2cdc49" alt="" width="375"><figcaption></figcaption></figure>

#### Step 6: Configure API Permissions

* Click **API Permissions** in the left menu.
* Delete any existing **Delegated permissions**.
* Click **Add a permission**.
* Select **Microsoft Graph**.
* Choose **Application permissions**.
* Search and add the following permissions:
  * **User.Read.All**
  * **Calendars.Read**

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FqIRephlRnwbmiJqxbVuV%2Fimage.png?alt=media&amp;token=7b0365c9-1588-4073-8522-62e9a6339250" alt=""><figcaption></figcaption></figure>

#### Step 7: Grant Admin Consent

* Click on **Grant admin consent** for your organization.
* Confirm the action.

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F43oRkr7udJOaBdAhvpMw%2Fimage.png?alt=media&amp;token=46567f54-3ca5-4f96-bd42-670cc7a6b718" alt="" width="375"><figcaption></figcaption></figure>

***

#### Step 8: Final Setup in Hivel

* Go to the **Integrations** page on your Hivel instance.
* Select **Outlook Integration**.
* Paste the **Tenant ID**, **Client ID**, and **Client Secret** you saved earlier.
* Confirm and save.

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FlHXn0nkPOTptpIbcHyWs%2Fimage.png?alt=media&amp;token=6ce9ed6a-cf2e-49ba-9630-e1696fecdf00" alt="" width="188"><figcaption></figcaption></figure>

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FfvMBc01QCPauudFuFGuc%2Fimage.png?alt=media&amp;token=76e9f7ff-8176-46dd-9f3b-8fef2905a193" alt=""><figcaption></figcaption></figure>

***

#### What’s next?

* Your Outlook data will start syncing automatically and pull historical data for 90 days.
* The data processing will be completed within 2-24 hours depending on the number of users.
* You can now view the [<mark style="color:purple;">**Meetings Breakdown insights**</mark>](/using-hivel/cockpit/metrics-and-definitions/meetings-breakdown.md) for your teams within Hivel.

***

### Data Collected from Outlook

Once authorization is complete, Hivel will read outlook calendar data for all users under the admin account. The specific data points fetched from each calendar include:

* **id:** Unique identifier of the calendar event.
* **iCalUId:** Unique identifier for the event across calendar clients.
* **start:** Start time of the event.
* **end:** End time of the event.
* **isCancelled:** Indicates if the event has been canceled.
* **organizer:** The person who created or owns the event.
* **attendees:** List of participants invited to the event.
* **sensitivity:** The privacy level of the event (e.g., normal, personal, private, confidential).

#### Sync Frequency

* **Initial Sync:** Fetches calendar data for the past 90 days.
* **Incremental Sync:** Nightly updates to fetch events for the past 1 day.

{% hint style="info" %}
**Important**&#x20;

* We do not save any external users’ email addresses.
* If a meeting is marked as private, and Azure does not share invitee details, we do not store them.
  {% endhint %}

If you encounter any issues or need further assistance, feel free to reach out to [**support@hivel.ai**](mailto:support@hivel.ai)<br>

#### **Continue setting up your integrations**

Now that Outlook is connected, connect the rest of your on-prem tools to complete your setup - [Back to Integrations](https://docs.hivel.ai/integrations#on-prem-server-integrations).