Skip to main content
Webhooks send an HTTPS POST to your server when something happens in your organization, so you don’t have to poll.

Events

Every event has the same envelope:

Create an endpoint

Register in Settings → Integrations → Webhooks, or with the API:
The response includes a secret (whsec_…). It’s only returned once, so store it with your other secrets.

Verify signatures

Each delivery has a Capibo-Signature header:
v1 is an HMAC-SHA256 of {t}.{raw request body}, keyed with your endpoint secret. Reject requests with a bad signature, or with a timestamp more than five minutes old.

Delivery and retries

  • Respond with any 2xx within 10 seconds. Do heavy work, like downloading the video, in a background job.
  • Failed deliveries are retried with exponential backoff for up to 3 days.
  • Events can arrive more than once or out of order. Use the event id to skip duplicates.