Lead events

One event covers every way a lead can be created. The envelope is described in the overview.

lead.created

Fires when contact details are captured, by any route that can produce a lead:

• the agent captures details the visitor gave in conversation (source: "auto_detected")
• the visitor submits the lead card (source: "lead_form")
• they leave details as part of a human handoff
• a lead is created through the API

{
  "lead": {
    "id": 3312,
    "chatbot_id": 17,
    "conversation_id": 8214,
    "name": "Ada Lovelace",
    "email": "[email protected]",
    "phone": null,
    "company": "Analytical Engines",
    "details": {
      "need": "A 12-seat rollout for the analytics team",
      "budget": "$5k",
      "timeline": "Q4"
    },
    "source": "auto_detected",
    "status": "new",
    "created_at": "2026-08-26T10:02:00.000Z"
  }
}

Every field except id, chatbot_id, status and created_at can be null, depending on which fields the agent asks for and what the visitor gave. details carries the qualification answers; keys the visitor never answered are absent.

Next steps