Test Notion Webhooks with HookTest

Quick Start

Get Notion webhooks flowing to HookTest in under a minute:

1. Create a HookTest URL. Go to hooktest.dev and click Create Bin. Copy the webhook URL.
2. Add it to Notion webhook settings. Paste the HookTest URL as your webhook endpoint in the Notion developer dashboard. Select the events you want to receive.
3. Trigger an event and inspect. Perform an action in Notion (or use their test/sandbox mode) and watch the request appear in HookTest in real time. Check headers, body, and query parameters.

Common Notion Webhook Events

These are the most commonly tested Notion webhook events. Each one triggers an HTTP POST to your webhook URL with a JSON payload.

Verifying Notion Signatures

Notion signs every webhook request using the X-Notion-Signature header. You should always verify this signature in production to confirm the request actually came from Notion and was not tampered with in transit.

When testing with HookTest, you can inspect the raw signature header value in the request details. This is useful for verifying that your signature verification code handles the header format correctly before deploying to production.

See the official Notion webhook docs for the full signature verification algorithm and code samples.

Why Test Notion Webhooks?

Webhook handlers are notoriously hard to debug. You cannot see what Notion is sending until your endpoint receives it, and errors in your handler can cause silent failures — missed payments, lost data, or broken integrations.

HookTest gives you full visibility into every request before you write a line of handler code. Create a bin, point Notion at it, and see exactly what arrives: HTTP method, headers (including signatures), body, and query parameters. Once your handler is ready, use webhook forwarding to send requests to your local server in real time.

Related Guides