# On-Prem Outlook Integration

To integrate Microsoft Outlook with Hivel and enable [<mark style="color:purple;">Meetings Breakdown insights</mark>](/using-hivel/cockpit/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="/files/fN4ih8jngfgjgYOBuv49" 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:\
  \&#xNAN;*“Accounts in any organizational directory (Any Microsoft Azure AD tenant - Multitenant)”*.
* Click **Register**.

<figure><img src="/files/UoxX811bG6K45WwZMmWd" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/4uFXn62GCYnv0iMLf9MV" 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="/files/L3265267nd1rwJdkaCCD" alt="" width="253"><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="/files/F53rITCUq750RXZBn3QF" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/rxbtgcuxEve7CwPuAfNL" 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="/files/EajIc6m4I6bagIGCmozE" alt=""><figcaption></figcaption></figure>

#### Step 7: Grant Admin Consent

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

<figure><img src="/files/TKlVeVyivoZM7DURNGxU" 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="/files/NMpxuo3ADeKMxPa4uVsR" alt="" width="188"><figcaption></figcaption></figure>

<figure><img src="/files/Azhl4OxNVgNr0JJ2RveW" 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/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>**


---

# 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.hivel.ai/integrations/on-prem-setup/on-prem-outlook-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.