Notion

Set up the webhook in Notion

1. Create an internal integration in Notion and grant it access to the pages or databases you want to watch.
2. Add a webhook subscription with your Hooks endpoint URL (https://api.hooks.events/in/<endpoint-id>).
3. Leave the endpoint secret empty: Notion sends a one-time verification_token, and Hooks encrypts and stores it automatically before answering the handshake.

Signature verification

• HMAC-SHA256, lowercase hex over the raw body

Events Hooks normalizes

Normalized payload

Every adapter produces this shape before filters or templates run. The raw payload and sanitized headers stay attached for audit, but filters and templates read the normalized fields.

{
  "id": "evt_demo",
  "source": "notion",
  "type": "notion.received",
  "action": "received",
  "deliveryId": "delivery_demo",
  "subject": {
    "title": "Notion event"
  },
  "raw": {}
}

Filter and template examples

type equals "notion.received"

"Notion event: {{event.subject.title}}"

Retries and the delivery log

408, 425, 429, and 5xx responses retry with backoff and honor Retry-After; other 4xx responses fail permanently with a named code. Every attempt keeps the rendered request and the target response, so a failure points at one field or one status instead of a guess.

Common errors

Pair with a target

Reference

• Receiving eventshttps://developers.notion.com/reference/webhooks
• Verify signatureshttps://hooks.events/docs/signatures.md
• Payload templateshttps://hooks.events/docs/templates.md

Other sources