Skip to main content

Overview

Every webhook Sigma sends includes a signature in the request headers. You should verify this signature before processing any webhook payload to ensure the request genuinely came from Sigma and was not tampered with.
Always verify the signature before acting on the webhook payload.

How the Signature is Generated

Sigma generates the signature by:
  1. Concatenating your apiKey and apiSecret (with no separator): {apiKey}{apiSecret}
  2. Hashing the concatenated string using the HMAC-SHA256 algorithm, with your businessId as the payload
The result is the signature sent in the x-signature header.

How to Verify the Signature

To verify an incoming webhook:
  1. Retrieve the x-signature value from the request headers
  2. Concatenate your apiKey and apiSecret to form your hash secret
  3. Generate an HMAC-SHA256 hash of your businessId using the hash secret
  4. Compare your generated hash against the received signature — if they match, the webhook is valid
Your businessId is available on the Webhooks page in the Sigma dashboard.