Webhooks
Create Webhook
Create a new webhook for receiving real-time event notifications
POST
This endpoint creates a new webhook for receiving real-time event notifications.
Body Parameters
string
required
The webhook listener URL where events will be sent
array
required
A list of event types to listen for. Supported events:
action_log.completed,
action_log.failed, document.received, document.extracted, lead.created,
lead.updated, lead.completed, spread.started, spread.completed,
spread.failedobject
Custom headers to send with every delivery, as name-value pairs. Deliveries
are not signed, so set a secret header here and check it on your endpoint to
authenticate them — for example
{ "x-shared-secret": "<random value>" }.boolean
Whether the webhook should be enabled immediately (default:
true)string
Optional description for the webhook
Response
string
Unique identifier for the webhook
string
The webhook URL where events will be sent
array
Array of event types this webhook is subscribed to
boolean
Whether the webhook is currently enabled
string
Optional description for the webhook
string
ISO 8601 timestamp when the webhook was created
Your webhook endpoint should return a 200 status code within 5 seconds. If it
doesn’t, OmniAI will retry the delivery.