Microsoft Graph webhook events

6 Microsoft Graph event types in 2 resources. 5 have sample payloads.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

change

created

documented from Microsoft Graph docs (example)

A resource you subscribed to is created

Identified by changeType on each value item; lifecycleEvent on lifecycle notices Resource change

microsoft-graph-created.json
{
  "value": [
    {
      "id": "lsgTZMr9KwAAA",
      "subscriptionId": "{subscription_guid}",
      "subscriptionExpirationDateTime": "2016-03-19T22:11:09.952Z",
      "clientState": "secretClientValue",
      "changeType": "created",
      "resource": "users/{user_guid}@{tenant_guid}/messages/{long_id_string}",
      "tenantId": "84bd8158-6d4d-4958-8b9f-9d6445542f95",
      "resourceData": { … }
    }
  ]
}

Key fields

Field Type Example
value[0].id string lsgTZMr9KwAAA

Full schema: 14 fields.

From Microsoft Graph docs

  • Content type application/json

Send example to Inspect → View as JSON

updated

documented from Microsoft Graph docs (example)

A resource you subscribed to is updated

Identified by changeType on each value item; lifecycleEvent on lifecycle notices Resource change

microsoft-graph-updated.json
{
  "value": [
    {
      "subscriptionId": "{Subscription id}",
      "clientState": "{secret client state}",
      "changeType": "updated",
      "tenantId": "{Organization/Tenant id}",
      "resource": "communications/presences/{id}",
      "subscriptionExpirationDateTime": "2023-09-14T10:00:00.0000000Z",
      "resourceData": { … },
      "organizationId": "{Organization/Tenant id}"
    }
  ]
}

Send example to Inspect → View as JSON

deleted

documented No payload yet

A resource you subscribed to is deleted

Identified by changeType on each value item; lifecycleEvent on lifecycle notices Resource change

No payload yet.

Help fill this in → View as JSON

lifecycle

missed

documented official schema

Some change notifications weren't delivered, so resync

Identified by changeType on each value item; lifecycleEvent on lifecycle notices Resource lifecycle

microsoft-graph-missed.json
{
  "value": [
    {
      "subscriptionId": "<subscription_guid>",
      "subscriptionExpirationDateTime": "2019-03-20T11:00:00.0000000Z",
      "tenantId": "<tenant_guid>",
      "clientState": "<secretClientState>",
      "lifecycleEvent": "missed"
    }
  ]
}

Send example to Inspect → View as JSON

subscriptionRemoved

documented official schema

Graph removes the subscription, so create a new one

Identified by changeType on each value item; lifecycleEvent on lifecycle notices Resource lifecycle

microsoft-graph-subscriptionremoved.json
{
  "value": [
    {
      "subscriptionId": "<subscription_guid>",
      "subscriptionExpirationDateTime": "2019-03-20T11:00:00.0000000Z",
      "tenantId": "<tenant_guid>",
      "clientState": "<secretClientState>",
      "lifecycleEvent": "subscriptionRemoved"
    }
  ]
}

Send example to Inspect → View as JSON

reauthorizationRequired

documented official schema

The subscription needs reauthorizing before notifications pause

Identified by changeType on each value item; lifecycleEvent on lifecycle notices Resource lifecycle

microsoft-graph-reauthorizationrequired.json
{
  "value": [
    {
      "subscriptionId": "<subscription_guid>",
      "subscriptionExpirationDateTime": "2019-03-20T11:00:00.0000000Z",
      "tenantId": "<tenant_guid>",
      "clientState": "<secretClientState>",
      "lifecycleEvent": "reauthorizationRequired"
    }
  ]
}

Send example to Inspect → View as JSON

Buffer Graph's batches before they reach your handler.

Event Gateway accepts each batched POST, queues it and retries to your service on your schedule, so a slow handler doesn't lose notifications.

Not affiliated with Microsoft Graph. Facts are compiled from public sources and linked inline.