Update Lead

View as Markdown

Partial update for an existing Lead. All fields are sometimes.

Lost-reason rule (PRD §10.6): if the new lead_stage_id resolves to a stage where is_lost=true, the body MUST also carry lead_lost_reason_id.

Headers

{{tenant_key_name}}stringOptional

Request

This endpoint expects a multipart form.
lead_stage_idstringRequired

Optional: new stage UUID

inquiry_summarystringRequired

Optional: free-text inquiry

preferred_contact_methodstringRequired

Optional: phone|email|sms

Response

Successful response