Skip to content
Back to Help Center

Developers

Webhooks

Get notified when extractions finish or fail, instead of polling.

Setup

  1. Go to Dashboard → Webhooks
  2. Click Add Webhook
  3. Enter your endpoint URL (HTTPS only)
  4. Pick your events:
    • processing.completed — extraction done, results ready
    • processing.failed — extraction failed, credits refunded
    • test.ping — connectivity test
  5. Click Create

Verifying payloads

Every delivery includes an X-Webhook-Signature header. Verify it with your webhook secret:

signature = sign(webhook_secret, raw_request_body)

See the developer docs for a full code example.

Retries

Failed deliveries retry with exponential backoff. If your endpoint keeps failing, the webhook gets auto-disabled. Re-enable it from the dashboard once your endpoint is fixed.

Testing

Click Send Test next to any webhook to fire a test.ping event. Check that your endpoint responds 200.