> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clarasdr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks & events

> Real-time events for qualification, routing, booking, and conversation outcomes - with payload examples and verification.

Clara emits webhook events for everything your systems need to react to: qualification outcomes, routing decisions, booked meetings, and conversation completions. Subscribe once and build any downstream workflow.

## Supported events

| Event                     | Fires when                                          |
| ------------------------- | --------------------------------------------------- |
| `conversation.started`    | A buyer conversation begins                         |
| `conversation.completed`  | A buyer conversation ends                           |
| `qualification.completed` | The qualification flow finishes with logged answers |
| `lead.qualified`          | A lead passes qualification                         |
| `meeting.booked`          | Clara books a meeting                               |
| `crm.sync.completed`      | A CRM record sync completes                         |

## Payload example

Every event ships as a JSON POST with the conversation context attached:

```json theme={null}
{
  "event": "lead.qualified",
  "timestamp": "2026-05-14T09:24:00Z",
  "conversation_id": "cnv_8f3k2m",
  "lead": {
    "name": "Jordan Lee",
    "company": "Acme Corp",
    "email": "jordan@acme.example"
  },
  "qualification": {
    "framework": "BANT",
    "answers": [
      { "question": "What does your budget look like for this quarter?", "answer": "We have budget allocated for Q3." },
      { "question": "Who else is involved in this decision?", "answer": "Our CTO and procurement lead." }
    ]
  },
  "routing": {
    "team": "enterprise",
    "reason": "qualification_passed"
  }
}
```

The qualification payload includes every question and answer in full detail - see [Qualifying questions](/docs/sales/qualifying-questions) for what's logged.

## Subscribing

1. Open **Webhooks** in your workspace.
2. Add your endpoint URL.
3. Select the events to subscribe to.
4. Save. Events POST immediately as they occur.

## Verification

Sign requests so your endpoint can trust the source:

* Requests include a signature header derived from your shared secret
* Verify the signature before processing the payload
* Respond with `2xx` quickly; retry behavior applies to failed deliveries

<Tip>
  Build against `conversation.completed` first - it's the event most integrations start with, and the payload carries the full transcript.
</Tip>