Skip to content
Close
LOGIN
Contact us
Contact us
2dsc05734

How to integrate Occulights with Microsoft Graph API

This guide walks you through the steps to register and configure an enterprise application in Azure Active Directory (Azure AD) for integrating Occulights with Microsoft Graph API.

Prerequisites

  1. Azure Active Directory admin access

  2. Occulights integration requirements (e.g., redirect URIs, required Graph API permissions)

  3. Microsoft 365 tenant (or Azure AD environment)

Step 1: Log in to Azure portal

  1. Navigate to https://portal.azure.com.
  2. Sign in with your admin credentials.

Step 2: Register a new application

Go to Microsoft Entra ID.

image-png-3

  1. Click "App registrations" from the left-hand menu.

  2. Click "New registration".

  3. Fill in the following details:

    • Name: Occulights Integration (or any name you like)

    • Supported account types: Choose the appropriate option ("Accounts in this organizational directory only").

    • Redirect URI: Choose "Web" and enter the URI provided by Occulights (e.g., https://occulights.com/oauth/callback)

image-png-4

5    Click "Register".


 

Step 3: Configure API permissions

  1. After registration, go to the "Manage" tab.

  2. Click "API Permissions".


image-png-May-25-2025-08-23-47-3868-AM


3     Click "Add a permission".

4     Choose Microsoft Graph.

image-png-May-25-2025-08-24-19-9343-AM

 

5     Select the type of permissions:

Application permissions


6     Add the permissions required by Occulights.

  • Calendars.ReadWrite
  • Users.Read


image-png-May-25-2025-08-30-12-3238-AM

 

7      Click "Add permissions".

8.    Click "Grant admin consent" for your organization.

 

image-png-May-25-2025-08-31-33-8244-AM

 

Step 4: Create a client secret

  1. Go to the "Certificates & secrets" tab.
  2. Under Client secrets, click "New client secret".
  3. Add a description and choose an expiry period (e.g., 6 months, 12 months).

 

image-png-May-25-2025-08-33-32-5510-AM

4     Click "Add".

image-png-May-25-2025-08-35-49-2524-AM

5     Copy the secret value

 

Step 5: Collect app credentials

You will need the following details to complete the integration with Occulights:

  • Application (client) ID

  • Directory (tenant) ID

  • Client secret (just created)

image-png-May-25-2025-08-38-29-3464-AM

 

Step 6: Log in and create the integration in Occulights

  1. Navigate to https://app.occulights.com.

  2. Sign in with your admin credentials.

  3. Go to "Integrations"
  4. Click on the "+" icon to create 
image-png-May-25-2025-08-42-20-3910-AM


5       Fill in the values from the previous step. 

image-png-May-25-2025-08-43-39-4091-AM

 

6. Done