Latentface
Guides/Webhooks
🪝Integration

Webhooks

Receive async notifications for long-running jobs, quota alerts, and usage events. Verified signatures included.

Requirements

  • →A public HTTPS endpoint
  • →Ability to verify HMAC-SHA256 signatures
1

Register a webhook

Dashboard → Webhooks → Add Endpoint. Paste your URL, pick the events you want (`job.completed`, `quota.80pct`, `key.revoked`), save.

2

Verify the signature

Every webhook includes an `X-Latentface-Signature` header — HMAC-SHA256 of the raw body with your webhook secret. Reject any request where the signature does not match.

Tip: Verify before parsing JSON. Invalid signatures mean the request did not come from us.
3

Respond quickly

Return a 2xx within 10 seconds. If we get a non-2xx or a timeout, we retry with exponential backoff up to 24 hours before giving up.

4

Replay failed deliveries

Dashboard → Webhooks → Deliveries shows every request and response. Click Replay on any failed delivery to re-send it after you've fixed your endpoint.

Ready to go live?

Start your first Latentface session for free — no credit card required.