Skip to main content
PostSyncer signs every webhook request with the Standard Webhooks scheme. Verify the signature before you trust the body, so nobody else can post to your address and pass as PostSyncer.

Headers

Your secret

The signing secret starts with whsec_. Create returns it in full. Later you can see it again in the app under Settings → Agents & Integrations → Webhooks (Reveal), or rotate it there. Everything after whsec_ is base64; decode it to get the key bytes.

How the signature is made

  1. Take the exact raw request body, before any JSON parsing.
  2. Build the string {webhook-id}.{webhook-timestamp}.{body}.
  3. Compute an HMAC-SHA256 of it with the decoded key.
  4. Base64 encode the result and compare it, in constant time, to the value after v1, in webhook-signature.
  5. Refuse requests whose timestamp is more than 5 minutes from your clock.

Use a library

The Standard Webhooks libraries do all of this for you.

Answer fast

Reply with a 2xx status within 10 seconds, and do slow work after you have answered. An answer of 408, 429 or 5xx, or no answer, is tried again up to 7 times over about 41 hours. See Webhooks for the full rules.

Test it

Use Test webhook to send a signed webhook.test event to your endpoint, then check List deliveries for what your server answered.