{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Notion.",
  "vendor": "notion",
  "name": "Notion",
  "official_docs": "https://developers.notion.com/reference/webhooks-events-delivery",
  "docs_checked": "2026-10-18",
  "url": "https://hookdeck.com/webhooks/notion",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/notion"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/notion/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/notion/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/notion/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/notion/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/notion/skill"
    }
  ],
  "summary": "Notion signs every webhook with X-Notion-Signature (HMAC-SHA256, despite what the docs say).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "X-Notion-Signature",
      "detail": "Format: sha256=<hex>",
      "source": {
        "kind": "vendor-docs",
        "label": "Notion docs",
        "href": "https://developers.notion.com/reference/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Notion docs",
        "href": "https://developers.notion.com/reference/webhooks"
      },
      "doc_discrepancy": {
        "claim": "Notion's sample code hashes `JSON.stringify(body)` over a parsed body, while the same page's SDK note says re-serialized JSON fails verification. The sample only works when serialization reproduces the bytes. Hash the raw body.",
        "url": "https://developers.notion.com/reference/webhooks",
        "confirmed": false
      }
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{raw body}",
      "detail": "The request body exactly as sent, with nothing added. No timestamp is added to the signed content.",
      "source": {
        "kind": "vendor-docs",
        "label": "Notion docs",
        "href": "https://developers.notion.com/reference/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "type field in the body",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Notion docs",
        "href": "https://developers.notion.com/reference/webhooks-events-delivery"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "Notion docs",
        "href": "https://developers.notion.com/reference/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "versioning",
      "label": "API versioning",
      "value": "api_version in the body",
      "detail": "Seen: 2022-06-28, 2025-09-03, 2026-03-11.",
      "source": {
        "kind": "vendor-docs",
        "label": "Notion docs",
        "href": "https://developers.notion.com/openapi.json"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "id, timestamp, workspace_id, workspace_name, subscription_id, integration_id, type, authors, accessible_by, attempt_number, api_version, entity, data",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Notion docs",
        "href": "https://developers.notion.com/reference/webhooks-events-delivery"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill notion-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/notion/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://developers.notion.com/reference/webhooks-events-delivery",
    "checked": "2026-11-04"
  },
  "counts": {
    "events": 31,
    "with_payload": 23,
    "captured": 0,
    "with_description": 31,
    "resources": 6,
    "confidence": {
      "verified": 0,
      "documented": 31,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any Notion event"
  },
  "events": [
    {
      "name": "page.content_updated",
      "resource": "page",
      "description": "Page content changes, such as a block added or removed",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#page.content_updated",
      "json": "https://hookdeck.com/webhooks/notion/events/page-content-updated.json"
    },
    {
      "name": "page.properties_updated",
      "resource": "page",
      "description": "A property value on a page changes",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#page.properties_updated",
      "json": "https://hookdeck.com/webhooks/notion/events/page-properties-updated.json"
    },
    {
      "name": "page.created",
      "resource": "page",
      "description": "New page appears where your connection has access",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#page.created",
      "json": "https://hookdeck.com/webhooks/notion/events/page-created.json"
    },
    {
      "name": "page.deleted",
      "resource": "page",
      "description": "Page goes to the trash",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#page.deleted",
      "json": "https://hookdeck.com/webhooks/notion/events/page-deleted.json"
    },
    {
      "name": "page.undeleted",
      "resource": "page",
      "description": "Page comes back from the trash",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#page.undeleted",
      "json": "https://hookdeck.com/webhooks/notion/events/page-undeleted.json"
    },
    {
      "name": "page.locked",
      "resource": "page",
      "description": "Page is locked against edits",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#page.locked",
      "json": "https://hookdeck.com/webhooks/notion/events/page-locked.json"
    },
    {
      "name": "page.unlocked",
      "resource": "page",
      "description": "Page lock is removed",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#page.unlocked",
      "json": "https://hookdeck.com/webhooks/notion/events/page-unlocked.json"
    },
    {
      "name": "page.moved",
      "resource": "page",
      "description": "Page moves to a new location",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#page.moved",
      "json": "https://hookdeck.com/webhooks/notion/events/page-moved.json"
    },
    {
      "name": "page.transcription_block.transcript_deleted",
      "resource": "page",
      "description": "Transcript deleted from a page's transcription block",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/notion/events#page.transcription_block.transcript_deleted",
      "json": "https://hookdeck.com/webhooks/notion/events/page-transcription-block-transcript-deleted.json"
    },
    {
      "name": "data_source.created",
      "resource": "data_source",
      "description": "Data source added to an existing database",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#data_source.created",
      "json": "https://hookdeck.com/webhooks/notion/events/data-source-created.json"
    },
    {
      "name": "data_source.content_updated",
      "resource": "data_source",
      "description": "Data source content changes, such as a child page added",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#data_source.content_updated",
      "json": "https://hookdeck.com/webhooks/notion/events/data-source-content-updated.json"
    },
    {
      "name": "data_source.schema_updated",
      "resource": "data_source",
      "description": "Data source properties added, changed or removed",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#data_source.schema_updated",
      "json": "https://hookdeck.com/webhooks/notion/events/data-source-schema-updated.json"
    },
    {
      "name": "data_source.deleted",
      "resource": "data_source",
      "description": "Data source goes to the trash",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#data_source.deleted",
      "json": "https://hookdeck.com/webhooks/notion/events/data-source-deleted.json"
    },
    {
      "name": "data_source.moved",
      "resource": "data_source",
      "description": "Data source moves to a different database",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#data_source.moved",
      "json": "https://hookdeck.com/webhooks/notion/events/data-source-moved.json"
    },
    {
      "name": "data_source.undeleted",
      "resource": "data_source",
      "description": "Data source comes back from the trash",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#data_source.undeleted",
      "json": "https://hookdeck.com/webhooks/notion/events/data-source-undeleted.json"
    },
    {
      "name": "database.created",
      "resource": "database",
      "description": "Database created with a default data source",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#database.created",
      "json": "https://hookdeck.com/webhooks/notion/events/database-created.json"
    },
    {
      "name": "database.schema_updated",
      "resource": "database",
      "description": "Database properties change, on API versions before 2025-09-03",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#database.schema_updated",
      "json": "https://hookdeck.com/webhooks/notion/events/database-schema-updated.json"
    },
    {
      "name": "database.content_updated",
      "resource": "database",
      "description": "Database content changes, on API versions before 2025-09-03",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#database.content_updated",
      "json": "https://hookdeck.com/webhooks/notion/events/database-content-updated.json"
    },
    {
      "name": "database.deleted",
      "resource": "database",
      "description": "Database goes to the trash",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#database.deleted",
      "json": "https://hookdeck.com/webhooks/notion/events/database-deleted.json"
    },
    {
      "name": "database.moved",
      "resource": "database",
      "description": "Database moves to a different parent",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#database.moved",
      "json": "https://hookdeck.com/webhooks/notion/events/database-moved.json"
    },
    {
      "name": "database.undeleted",
      "resource": "database",
      "description": "Database comes back from the trash",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#database.undeleted",
      "json": "https://hookdeck.com/webhooks/notion/events/database-undeleted.json"
    },
    {
      "name": "comment.created",
      "resource": "comment",
      "description": "Comment or suggested edit added to a page or block",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#comment.created",
      "json": "https://hookdeck.com/webhooks/notion/events/comment-created.json"
    },
    {
      "name": "comment.updated",
      "resource": "comment",
      "description": "Comment edited, or its attached file finishes uploading",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#comment.updated",
      "json": "https://hookdeck.com/webhooks/notion/events/comment-updated.json"
    },
    {
      "name": "comment.deleted",
      "resource": "comment",
      "description": "Comment is removed",
      "confidence": "documented",
      "schema_source": "from Notion docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/notion/events#comment.deleted",
      "json": "https://hookdeck.com/webhooks/notion/events/comment-deleted.json"
    },
    {
      "name": "file_upload.created",
      "resource": "file_upload",
      "description": "File upload object created",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/notion/events#file_upload.created",
      "json": "https://hookdeck.com/webhooks/notion/events/file-upload-created.json"
    },
    {
      "name": "file_upload.completed",
      "resource": "file_upload",
      "description": "External file import finishes successfully",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/notion/events#file_upload.completed",
      "json": "https://hookdeck.com/webhooks/notion/events/file-upload-completed.json"
    },
    {
      "name": "file_upload.expired",
      "resource": "file_upload",
      "description": "File upload expires before it's completed and attached",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/notion/events#file_upload.expired",
      "json": "https://hookdeck.com/webhooks/notion/events/file-upload-expired.json"
    },
    {
      "name": "file_upload.upload_failed",
      "resource": "file_upload",
      "description": "External file import fails, with the error in the body",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/notion/events#file_upload.upload_failed",
      "json": "https://hookdeck.com/webhooks/notion/events/file-upload-upload-failed.json"
    },
    {
      "name": "view.created",
      "resource": "view",
      "description": "Database view created, with its view type in the body",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/notion/events#view.created",
      "json": "https://hookdeck.com/webhooks/notion/events/view-created.json"
    },
    {
      "name": "view.updated",
      "resource": "view",
      "description": "Database view's name, filter, sorts or configuration changes",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/notion/events#view.updated",
      "json": "https://hookdeck.com/webhooks/notion/events/view-updated.json"
    },
    {
      "name": "view.deleted",
      "resource": "view",
      "description": "Database view deleted",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/notion/events#view.deleted",
      "json": "https://hookdeck.com/webhooks/notion/events/view-deleted.json"
    }
  ]
}