> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apowerb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook webhooks

> Wire Outlook push notifications through Microsoft Graph.

## Prerequisites

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

## Setup

<Steps>
  <Step title="Configure the environment">
    Set the `MICROSOFT_INTEGRATION_*` variables — see [Configuration](/configuration).
  </Step>

  <Step title="Connect Outlook">
    From the interface, connect the Outlook integration.
  </Step>

  <Step title="Subscribe">
    Create a webhook subscription with `"provider": "microsoft_outlook"`.
  </Step>
</Steps>

The handler uses Microsoft Graph change notifications and validates `clientState` on
every delivery. Subscriptions expire after three days and are renewed automatically —
see [Webhooks](/guides/webhooks).


## Related topics

- [Webhooks](/guides/webhooks.md)
- [Create Subscription](/api-reference/webhooks/create-subscription.md)
- [Receive Notification](/api-reference/webhooks/receive-notification.md)
- [Debug Outlook Token Scopes](/api-reference/integrations/debug-outlook-token-scopes.md)
- [Rag Webhook](/api-reference/rag/rag-webhook.md)