Skip to main content

​
What are Webhooks?

Webhooks are HTTP callbacks that notify your system when events occur on the Leavo platform.

​
Webhook Types

Inbound

Receive notifications about events in your Leavo account (new leads, status changes, etc.)

Outbound

Receive AI response callbacks when using debounce mode

​
Supported Events

EventDescription
lead.createdNew lead created
lead.updatedLead data updated
lead.deletedLead deleted
lead.status_changedLead status changed
message.receivedNew message received
message.sentMessage sent
ai.responseAI processing completed

​
Webhook Payload

{
  "event": "lead.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": "lead-uuid",
    "name": "John Smith",
    "phone": "+15551234567",
    "email": "[email protected]"
  }
}

​
Best Practices

1

Respond Quickly

Return HTTP 200 as fast as possible. Process in background.
2

Handle Duplicates

Implement idempotency - the same event may be sent multiple times.
3

Verify Origin

Validate that the request actually came from Leavo.
4

Log Everything

Keep logs of all received events for debugging.