Appearance
PATCH /public/v1/leads/
| Auth | Required |
| Scope | leads:write |
| Idempotency-Key | Not used |
Updates stage, title, expected fee, notes, or external_source. Send at least one field. This call does not move the lead to a different organization. Send POST /leads with the same external_reference when the source system should refresh the whole lead.
json
{ "stage": "proposal", "amount_cents": 57500 }amount_cents is the expected engagement fee in cents. stage is lead, qualified, proposal, won, or lost.
Response is the lead with action: "updated". Webhook: lead.upserted.
Errors
| Status | Code |
|---|---|
| 403 | insufficient_scope |
| 404 | not_found |
| 422 | validation_error |