Notion Webhooks

When to Use This Skill

• Setting up Notion webhook handlers for an internal integration
• Debugging Notion signature verification failures
• Completing the one-time verification_token handshake to activate a subscription
• Handling page, comment, database, or data source events from a Notion workspace

Essential Code (USE THIS)

Notion uses HMAC-SHA256 over the raw request body with the integration's verification_token as the signing key. The signature is sent in the X-Notion-Signature header in the format sha256=<hex_digest>.