On-Prem Outlook Integration

To integrate Microsoft Outlook with Hivel and enable , 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

Step 2: Navigate to App Registrations

In the Azure portal search bar, type App Registrations and open it.

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.

Step 4: Save Your IDs

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

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.

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

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

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.

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.

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.
subject: The title or subject of the event.
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).