Skip to main content

​
Prerequisites

  • A Microsoft Azure AD application
  • Microsoft Graph permissions
  • A publicly reachable HTTPS URL

​
Register an Application

To establish the connection, you first need to register an application in the Microsoft Entra admin center:
1

Create App Registration

Go to App registrations > New registration.
  • Name: apowerb-integration
  • Supported account types: Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts
  • Redirect URI: https://your-domain.com/api/v1/auth/callback (or your local setup)
2

Generate Client Secret

Navigate to Certificates & secrets > Client secrets > New client secret. Save the value securely.
3

API Permissions

Go to API permissions > Add a permission > Microsoft Graph.
  • For Outlook: Select Mail.Read, Mail.Send, Calendars.Read
  • For OneDrive: Select Files.Read.All, Files.ReadWrite
  • Click Grant admin consent if required.

​
Setup

1

Configure the environment

Set the following MICROSOFT_INTEGRATION_* variables in your environment:
  • MICROSOFT_CLIENT_ID: Your Application (client) ID
  • MICROSOFT_CLIENT_SECRET: Your generated client secret
  • MICROSOFT_TENANT_ID: Your Directory (tenant) ID (use common for multitenant) See Configuration.
2

Connect services

From the interface, navigate to Integrations and select Microsoft. Connect your account using the configured app details.
The handler uses Microsoft Graph change notifications. Subscriptions expire after three days and are renewed automatically — see Webhooks.