Skip to main content

Prerequisites

  • A registered Microsoft Azure AD application
  • Microsoft Graph permission Mail.Read
  • A publicly reachable HTTPS URL

Setup

1

Configure the environment

Set the MICROSOFT_INTEGRATION_* variables — see Configuration.
2

Connect Outlook

From the interface, connect the Outlook integration.
3

Subscribe

Create a webhook subscription with "provider": "microsoft_outlook".
The handler uses Microsoft Graph change notifications and validates clientState on every delivery. Subscriptions expire after three days and are renewed automatically — see Webhooks.