Skip to main content
Deliveries follow Standard Webhooks. Each one has three headers: The HMAC key is your secret without whsec_, base64-decoded. During a secret rotation, two signatures come, separated by a space: accept either. Which secret:
  • A task’s webhookUrl: the organization’s task webhook secret, in the dashboard under Webhooks.
  • An endpoint you added in the dashboard: that endpoint’s secret, shown when you add it or rotate it.
Check the raw body, as it arrived, before you parse it. JSON that you parse and serialize again can differ by one byte, and the check then fails.

Verify by hand

In a server

With a library

A Standard Webhooks library does the same check in one call. It accepts the secret with its whsec_ prefix.
Libraries exist for Go, Ruby, PHP, Java, Rust, C# and more. See standardwebhooks.com.