> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hymalaia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook Connector

> Configure the Outlook connector in Hymalaia

## Overview

The Outlook connector allows you to integrate Microsoft Outlook email and calendar data into the Hymalaia platform.

## Prerequisites

* Microsoft Azure Active Directory account
* Application registered in Azure Active Directory

## Configuration Steps

### 1. Azure Active Directory Setup

1. Go to the [Azure Portal](https://portal.azure.com/)
2. Navigate to **Azure Active Directory** > **App registrations**
3. Click **New registration**

### 2. Connector Credentials

You can use the same credentials as your SharePoint connector:

* **Client ID**: Your Azure AD application's client ID
* **Directory ID**: Your Azure AD tenant ID
* **Secret Code**: Client secret generated in Azure AD

### 3. Required Scopes

Add the following scopes to enable email and calendar access:

* `Mail.Read`: Allows reading email messages
* `Calendars.Read`: Allows reading calendar events

### 4. Redirect URIs

Configure the following redirect URI in your Azure AD application:

* `https://<YOUR_DEPLOYMENT_URL>/admin/connectors/outlook/auth/callback`
* `http://localhost:3000/admin/connectors/outlook/auth/callback` (for local development)

## Permissions and Consent

> 🔐 Ensure that an administrator consents to the application permissions for the specified scopes.

## Troubleshooting

* Verify that the application has the correct API permissions
* Check that the client secret has not expired
* Confirm that the user performing the OAuth flow has the necessary access rights

## Best Practices

* Use a dedicated service account for the connector
* Regularly rotate your client secret
* Limit the scopes to only what is necessary for your use case