← All product updates

March 27, 2026

Webhook signing secrets for payload verification

Webhook signing secrets for payload verification
Pablo Durán
Pablo Durán

Software Engineer at TheirStack

Your webhooks can now include a signing secret so every delivery is cryptographically signed.

Until now, there was no built-in way to confirm that an incoming payload actually originated from TheirStack—your endpoint had to rely on source IP or URL alone.

Set a signing secret (minimum 16 characters) and every delivery will carry an X-TheirStack-Signature-256 header containing the HMAC-SHA256 signature of the raw payload. Recompute the HMAC on your side and compare to confirm authenticity and integrity.

In practice:

  • Payload authenticity — Know for certain each delivery was sent by TheirStack, not a third party.
  • Tamper detection — Any modification to the payload in transit will cause the signature check to fail.
  • One-click setup — Generate a secret directly in the webhook form, or bring your own. Also available via the webhooks API.

See the verification guide for code examples and step-by-step instructions.