Overview

To integrate Microsoft Outlook Calendar with ClayHR, you first need to create and configure an Azure application in your Microsoft 365 tenant. This guide walks Azure Admins through registering the app and setting it up to allow ClayHR to sync events like leaves and announcements.

‍

‍Step 1: Register a New Application

1. Sign in to the Azure Portal.
   

2. Search for App registrations in the top search bar.
   

3. Click + New registration.
   

4. Enter a name like ClayHR Calendar App.
   

5. Leave redirect URL blank.
   
   
6. Click Register.
   
   • After registration:
     
     • Note down the Application (client) ID for later use.
     • Note down Directory (tenant) ID
   • You'll need these in the ClayHR integration setup.
     
     

Step 2: Generate a Client Secret

1. Go to Certificates & secrets in the left panel.
   
2. Click + New client secret.
   
3. Add a description like Calendar Integration Key.
   

4. Choose an expiration duration (e.g., 24 months).
5. Click Add.
   

Make sure to note down the Value of the secret immediately — it will only be shown once.

Step 3: Grant Microsoft Graph Permissions

1. Click API permissions in the left panel.
   
2. Click + Add a permission → Select Microsoft Graph.
   
3. Choose Application permissions and add:
   
   
   • Calendars.Read
   • Calendars.ReadBasic.All
   • Calendars.ReadWrite

4. After adding, click Grant admin consent for [Your Organization] to authorize these permissions for use across your tenant.

Note: The app will also include the User.Read Delegated permission, which is automatically added when the app is created.

Azure Setup Complete

You have now completed the Azure-side setup. Proceed to Connect Microsoft Calendar with ClayHR to finalize the integration.

Troubleshooting (Azure Setup)