​

Webhook Events

This page provides an overview of all available webhook events. Each event type has its own detailed documentation page.

​

Event Types

​

Action Log Events

Track agent activity and action completion:

​

Document Events

Track document collection and processing:

​

Lead Events

Track lead lifecycle:

​

Spread Events

Track financial spreading runs:

​

Webhook Delivery

​

Request Format

Webhooks are sent as HTTP POST requests with:

• Content-Type: application/json
• Method: POST
• Body: JSON payload containing the event data

​

Response Requirements

Your webhook endpoint should:

• Return a 200 OK status code within 5 seconds
• Handle requests asynchronously if processing takes longer
• Return appropriate error codes for invalid requests

​

Retry Logic

If your endpoint doesn’t respond with a 2xx status code within 5 seconds, OmniAI will retry:

• Initial retry: After 1 minute
• Subsequent retries: Backoff of roughly 2, 5, 10, then 20 minutes
• Maximum: 6 total attempts

​

Security

​

Authenticating Deliveries

Deliveries are not signed. To authenticate them, set custom headers on the subscription — for example a shared-secret header — and reject requests to your endpoint that don’t carry it. See Create Webhook.

​

Best Practices

• Use HTTPS endpoints only
• Reject deliveries that don’t carry your secret header
• Implement idempotency to handle duplicate events
• Set up retry logic for failed webhook deliveries
• Monitor webhook delivery status

​

Related Guides