Lead won

webhook

leadWon

Triggered when a lead reaches the Won stage, which happens when its
proposal is won. Fires alongside lead_stage_changed, with the same
payload - subscribe to one or the other, not both, unless you want to
handle the close twice.

Sent only for practices subscribed to the Leads add-on.

Payload

Webhook envelope for lead events. The payload field contains the full Lead
resource, exactly as GET /api/v1/leads/{lead} returns it.

Stage-change events (lead_stage_changed, lead_won, lead_lost) add
previousStage and newStage alongside the lead's own fields. Stage names
are renamable by the practice, so key on id or systemKey rather than
name.

A lead reaching Won or Lost sends lead_stage_changed and the dedicated
event, so a receiver watching general movement does not miss the close.

Lead events are only sent for practices subscribed to the Leads add-on.

event

string

enum

required

The lead event type that triggered the webhook

Allowed:

payload

object

required

entropy

string

required

length between 16 and 16

Random 16-character string for replay detection

timestamp

date-time

required

UTC timestamp of when the webhook was created (ISO 8601)

Response

200

Webhook received successfully