{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Microsoft Graph.",
  "vendor": "microsoft-graph",
  "name": "Microsoft Graph",
  "official_docs": "https://learn.microsoft.com/en-us/graph/api/resources/changenotification",
  "docs_checked": "2026-10-28",
  "url": "https://hookdeck.com/webhooks/microsoft-graph",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/microsoft-graph"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/microsoft-graph/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/microsoft-graph/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/microsoft-graph/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/microsoft-graph/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/microsoft-graph/skill"
    }
  ],
  "summary": "Microsoft Graph doesn't sign its webhooks.",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "None (unsigned)",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Microsoft Graph docs",
        "href": "https://learn.microsoft.com/en-us/graph/change-notifications-delivery-webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "changeType on each value item; lifecycleEvent on lifecycle notices",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Microsoft Graph docs",
        "href": "https://learn.microsoft.com/en-us/graph/api/resources/changenotification"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Microsoft Graph docs",
        "href": "https://learn.microsoft.com/en-us/graph/change-notifications-delivery-webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "families",
      "label": "Event families",
      "value": "change notifications, lifecycle notifications",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Microsoft Graph docs",
        "href": "https://learn.microsoft.com/en-us/graph/api/resources/changenotification"
      },
      "doc_discrepancy": null
    },
    {
      "key": "handshake",
      "label": "URL handshake",
      "value": "POST: echo the challenge",
      "detail": "Answer within 10 seconds with 200, text/plain and the URL-decoded validationToken.",
      "source": {
        "kind": "vendor-docs",
        "label": "Microsoft Graph docs",
        "href": "https://learn.microsoft.com/en-us/graph/change-notifications-delivery-webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "value, validationTokens",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Microsoft Graph docs",
        "href": "https://learn.microsoft.com/en-us/graph/api/resources/changenotification"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill microsoft-graph-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/microsoft-graph/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://learn.microsoft.com/en-us/graph/api/resources/changenotification",
    "checked": "2026-07-29"
  },
  "counts": {
    "events": 6,
    "with_payload": 5,
    "captured": 0,
    "with_description": 6,
    "resources": 2,
    "confidence": {
      "verified": 0,
      "documented": 6,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any Microsoft Graph event"
  },
  "events": [
    {
      "name": "created",
      "resource": "change",
      "description": "A resource you subscribed to is created",
      "confidence": "documented",
      "schema_source": "from Microsoft Graph docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/microsoft-graph/events#created",
      "json": "https://hookdeck.com/webhooks/microsoft-graph/events/created.json"
    },
    {
      "name": "updated",
      "resource": "change",
      "description": "A resource you subscribed to is updated",
      "confidence": "documented",
      "schema_source": "from Microsoft Graph docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/microsoft-graph/events#updated",
      "json": "https://hookdeck.com/webhooks/microsoft-graph/events/updated.json"
    },
    {
      "name": "deleted",
      "resource": "change",
      "description": "A resource you subscribed to is deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/microsoft-graph/events#deleted",
      "json": "https://hookdeck.com/webhooks/microsoft-graph/events/deleted.json"
    },
    {
      "name": "missed",
      "resource": "lifecycle",
      "description": "Some change notifications weren't delivered, so resync",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/microsoft-graph/events#missed",
      "json": "https://hookdeck.com/webhooks/microsoft-graph/events/missed.json"
    },
    {
      "name": "subscriptionRemoved",
      "resource": "lifecycle",
      "description": "Graph removes the subscription, so create a new one",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/microsoft-graph/events#subscriptionRemoved",
      "json": "https://hookdeck.com/webhooks/microsoft-graph/events/subscriptionremoved.json"
    },
    {
      "name": "reauthorizationRequired",
      "resource": "lifecycle",
      "description": "The subscription needs reauthorizing before notifications pause",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/microsoft-graph/events#reauthorizationRequired",
      "json": "https://hookdeck.com/webhooks/microsoft-graph/events/reauthorizationrequired.json"
    }
  ]
}