SDKs & Integrations
Webhooks
Receive real-time event notifications from DokuBrain.
Webhooks
Webhooks notify your application in real-time when events occur in DokuBrain. Configure a URL, choose which events to subscribe to, and DokuBrain will send HTTP POST requests with event data.
Setting up webhooks
Event types
| Event | Trigger |
|---|---|
document.uploaded | Document upload completed |
document.processed | Document parsing and embedding finished |
document.classified | Document type classified |
document.extracted | Field extraction completed |
document.deleted | Document was deleted |
workflow.started | Workflow run began |
workflow.step_completed | Individual workflow step finished |
workflow.completed | Full workflow run succeeded |
workflow.failed | Workflow run failed |
report.completed | Report execution finished |
Payload format
Signature verification
Verify that webhook requests actually come from DokuBrain using the X-DokuBrain-Signature header:
Retry policy
If your endpoint returns a non-2xx status code, DokuBrain retries with exponential backoff:
| Attempt | Delay |
|---|---|
| 1st retry | 1 minute |
| 2nd retry | 5 minutes |
| 3rd retry | 30 minutes |
| 4th retry | 2 hours |
| 5th retry | 12 hours |
After 5 failed attempts, the webhook is marked as failing. Fix the issue and re-enable it from the dashboard.