​
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
  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)

🔐 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