Webhook Payloads & Verification

Webhooks set to JSON (signed) send a JSON request to the webhook's URL each time a matching event happens. This page shows what those requests contain and how to check they came from Docvora. It's intended for teams connecting webhooks to their own apps, or to automation tools such as Zapier, Make and n8n.

Discord and Slack webhooks are sent as messages in those services' own formats, so they don't need any of the steps below.

Webhooks are available on Pro and Enterprise plans. Creating and managing webhooks requires the Webhooks staff permission. See Webhooks for creating a webhook.


Events

Each request has a type with one of these events:

Saving a page without changing anything doesn't send an event.


Example request

{
  "type": "page.updated",
  "timestamp": "2026-11-12T03:15:42.000Z",
  "data": {
    "site": {
      "name": "Acme Docs",
      "url": "https://docs.example.com"
    },
    "actor": {
      "id": "284019553376034816",
      "username": "Sam"
    },
    "space": {
      "id": "281397012381270016",
      "name": "Getting Started",
      "url": "https://docs.example.com/spaces/getting-started"
    },
    "page": {
      "id": "292551585216049152",
      "name": "Creating an account",
      "link": "creating-an-account",
      "url": "https://docs.example.com/spaces/getting-started/creating-an-account",
      "shortUrl": "https://docs.example.com/p/292551585216049152",
      "parentpage": null,
      "hidden": false,
      "archived": false,
      "readtime": 3,
      "summary": "Accounts can be created with an email address or a connected Google account...",
      "createdAt": 1760000000000,
      "updatedAt": 1762917342000
    },
    "changes": {
      "name": {
        "from": "Creating your account",
        "to": "Creating an account"
      }
    },
    "contentChanged": true
  }
}

Request fields

Page content

When Include page content is turned on for the webhook, data.page.content is added to every event except page.deleted:

Hidden and restricted pages

Events about hidden pages, pages restricted to groups, and pages in hidden or restricted spaces are only sent when Include hidden and restricted pages is turned on for the webhook.


Headers

Every JSON request is sent as a POST with these headers:


Verifying requests

Requests are signed with the webhook's signing secret using the Standard Webhooks format. Checking the signature confirms that a request came from Docvora and wasn't changed on the way.

The signing secret is shown on the webhook's page under Staff Panel > Integrations > Webhooks. It starts with whsec_ and should be kept private.

Using a Standard Webhooks library

Standard Webhooks libraries are available for most languages. In Node.js:

// npm install standardwebhooks
const {Webhook} = require('standardwebhooks');
const wh = new Webhook(process.env.WEBHOOK_SECRET);

// Use the raw request body, before it's parsed as JSON
const event = wh.verify(rawBody, request.headers); // throws if the signature is wrong
console.log(event.type, event.data.page.name);

Checking the signature by hand

  1. Take the part of the secret after whsec_ and decode it from base64. This is the signing key.

  2. Join the webhook-id header, the webhook-timestamp header and the raw request body with full stops: id.timestamp.body.

  3. Create an HMAC-SHA256 of that text using the signing key, and encode the result as base64.

  4. Compare it with the webhook-signature header, which is written as v1, followed by the signature.

It's also good practice to reject requests where webhook-timestamp is more than five minutes old.

Changing the secret

Select Create a new secret on the webhook's page to replace the secret. The old secret stops working straight away, so update the receiving app at the same time.


Responding to requests

The receiving app should respond with any 2xx status code, such as 200, within 10 seconds.

Test events from Send test are sent once and aren't retried.

Recent deliveries

The webhook's page lists the last 50 deliveries from the past 30 days, with the request that was sent and the response that came back. Any delivery can be sent again from this list.