Skip to content

PATCH /public/v1/leads/ ​

AuthRequired
Scopeleads:write
Idempotency-KeyNot 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 ​

StatusCode
403insufficient_scope
404not_found
422validation_error

API base: https://staging-api.appraiserflow.ai/public/v1 (af_test_ keys)