# Microsoft Graph webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/microsoft-graph/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill microsoft-graph-webhooks` ([details](https://hookdeck.com/webhooks/microsoft-graph/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Microsoft Graph's official docs](https://learn.microsoft.com/en-us/graph/api/resources/changenotification).

[Overview](https://hookdeck.com/webhooks/microsoft-graph) · [Webhook events (6)](https://hookdeck.com/webhooks/microsoft-graph/events) · [MCP events](https://hookdeck.com/webhooks/microsoft-graph/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/microsoft-graph/verify) · [Production guide](https://hookdeck.com/webhooks/microsoft-graph/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/microsoft-graph/skill)

## change

### created

Confidence: documented · Schema: from Microsoft Graph docs (example)

A resource you subscribed to is created

Identified by: changeType on each value item; lifecycleEvent on lifecycle notices · Object: `change`

```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": { … }
    }
  ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/microsoft-graph/events/created.json)

| Key field | Type | Example |
|---|---|---|
| `value[0].id` | string | `lsgTZMr9KwAAA` |

From Microsoft Graph docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/microsoft-graph/events/created.json)

### updated

Confidence: documented · Schema: from Microsoft Graph docs (example)

A resource you subscribed to is updated

Identified by: changeType on each value item; lifecycleEvent on lifecycle notices · Object: `change`

```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}"
    }
  ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/microsoft-graph/events/updated.json)

[View as JSON](https://hookdeck.com/webhooks/microsoft-graph/events/updated.json)

### deleted

Confidence: documented · Schema: No payload yet

A resource you subscribed to is deleted

Identified by: changeType on each value item; lifecycleEvent on lifecycle notices · Object: `change`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/microsoft-graph/events/deleted.json)

## lifecycle

### missed

Confidence: documented · Schema: official schema

Some change notifications weren't delivered, so resync

Identified by: changeType on each value item; lifecycleEvent on lifecycle notices · Object: `lifecycle`

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



[View as JSON](https://hookdeck.com/webhooks/microsoft-graph/events/missed.json)

### subscriptionRemoved

Confidence: documented · Schema: official schema

Graph removes the subscription, so create a new one

Identified by: changeType on each value item; lifecycleEvent on lifecycle notices · Object: `lifecycle`

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



[View as JSON](https://hookdeck.com/webhooks/microsoft-graph/events/subscriptionremoved.json)

### reauthorizationRequired

Confidence: documented · Schema: official schema

The subscription needs reauthorizing before notifications pause

Identified by: changeType on each value item; lifecycleEvent on lifecycle notices · Object: `lifecycle`

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



[View as JSON](https://hookdeck.com/webhooks/microsoft-graph/events/reauthorizationrequired.json)

---

Not affiliated with Microsoft Graph. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/microsoft-graph.json) · [Report a correction](https://hookdeck.com/contact)
