Source type

Notion Source Configuration

Notion sources receive page and database activity webhooks and verify each payload with the webhook verification token.

NOTIONPOST, PUT, PATCH, DELETEVerification TokenProductivity
Notion webhooks documentationAll source types
Notion sends webhook traffic to a FastHook source, FastHook validates the provider contract, records the request, and routes accepted events through connections to destinations.NotionProviderPOST, PUT, PATCH, DELETESignedFastHookSource URLNOTIONProvider credentialsignatureVerify before queue401 on auth failure405 on wrong methodAcceptedRequestverified: trueConnections route the accepted request to destinationsFilters, transformations, retries, replay, and destination signatures stay downstream from source verification.

Notion configuration

Create a Notion source, keep POST and PUT and PATCH and DELETE enabled, and provide the configured Verification Token values for provider signature. FastHook uses these settings to validate each Notion delivery before it enters the routing workflow.

Source Type

NOTION

Allowed methods

POST, PUT, PATCH, DELETE

Authentication

Provider signature

Credential fields

Verification Token

Notion source config
{
  "type": "NOTION",
  "config": {
    "auth_type": "PROVIDER_SIGNATURE",
    "auth": {
      "provider": "NOTION",
      "webhook_signing_secret": "verification-token"
    },
    "allowed_http_methods": ["POST","PUT","PATCH","DELETE"]
  }
}

Notion request contract

FastHook computes sha256= HMAC-SHA256 over the raw body with the Notion verification token and compares it with x-notion-signature.

POSTPUTPATCHDELETE

Notion headers

Preserve x-notion-signature when sending Notion test deliveries. FastHook evaluates this request context before accepting the payload, so missing or modified values remain visible as rejected requests instead of routed events.

x-notion-signature

sha256= HMAC-SHA256 signature over the raw request body.

Notion setup

  1. Create a Notion webhook subscription with the generated FastHook Source URL.
  2. Copy the one-time verification_token from Notion into FastHook.
  3. Use event type and page or database ids for routing and deduplication.

Notion routing hints

  • Notion activity webhooks usually route by event type, workspace, page id, or database id.
  • Use page or database ids near the receiver when repeated deliveries can create side effects.

Continue with Notion