> 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/on-prem-setup/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/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>**