Webhooks

Receive real-time notifications when events occur in your workspace instead of polling the Jobs endpoint.

How it works

1. Register a webhook URL from the Vidocu Dashboard
2. Select which events to subscribe to
3. Vidocu sends an HTTP POST to your URL when events fire
4. Your server responds with a 2xx status to acknowledge delivery

Availability

Webhooks are available on the Business plan and above, alongside the rest of the REST API.

Delivery

Webhooks are delivered as POST requests with a JSON body:

{
  "event": "video.analyzed",
  "data": { ... },
  "webhookId": "wh_abc123"
}

Headers

Header	Description
Content-Type	application/json
X-Vidocu-Event	Event type (e.g. video.analyzed)
X-Vidocu-Signature	HMAC SHA-256 signature for verification
X-Vidocu-Timestamp	Unix timestamp (seconds) when the event was sent
X-Vidocu-Delivery-Attempt	Attempt number (1–4)

Retries

Failed deliveries (non-2xx response or timeout) are retried up to 3 times with increasing delays:

Attempt	Delay
1st retry	1 second
2nd retry	2 seconds
3rd retry	4 seconds

Each delivery attempt has a 10-second timeout.

Auto-disable

After 10 consecutive failures, the webhook is automatically disabled. Re-enable it from the dashboard after fixing the endpoint.

Next steps

• Events — All available event types and their payloads
• Signatures — Verify webhook authenticity