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:secret (whsec_…). It’s only returned once, so store it with your other secrets.
Verify signatures
Each delivery has aCapibo-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
2xxwithin 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
idto skip duplicates.