Guides
6 min read
Set up webhooks
Receive events in real time, verify every payload signature, and handle retries so your endpoint never processes the same event twice.
Webhooks let your backend react the moment something happens, without polling. Tessera sends a POST request to your endpoint for every matching event.
1. Add an endpoint
Go to Settings, then Webhooks, and add the URL that should receive events. Choose which event names to subscribe to, or leave it empty to receive all of them.
2. Verify the signature
Each request includes a Tessera-Signature header. Compare it against an HMAC of the raw body using your signing secret, and reject anything that doesn’t match.
verify.js
import { verifyWebhook } from "@tessera/sdk" const event = verifyWebhook(rawBody, headers, process.env.TESSERA_SIGNING_SECRET)
3. Respond quickly
Return a 2xx status within 10 seconds. Tessera retries failed deliveries for up to 24 hours with increasing delays, so do heavy work in a background job.
Was this page helpful?
