Update a lead
Changes only the fields you send, checked with the organization’s field rules, and optionally the stage or the pipeline (pipelineId, with stageId for where in it). Every change is recorded on the lead’s timeline as made via the API.
Scope: leads.write.
Authorizations
An organization API key, created in Settings → Connections → API keys. Keys start with mk_live_. Marro stores only a hash of a key, so it is shown once, when it is created: copy it then. Revoking a key ends its access at once. To replace a key without downtime, create the new one, switch your server to it, then revoke the old one. Changes made with a key appear on the lead’s timeline as made by the person who created the key, via the API. Scopes: leads.read (Read leads), leads.write (Create and update leads), leads.capture (Capture leads).
Path Parameters
The lead’s ID.
x >= 1Body
Only the fields to change, by key. Send null to clear a field.
A stage of another pipeline moves the lead into that pipeline.
x <= 2147483647Moves the lead to this pipeline, at stageId (one of its stages) or its starting stage.
x <= 2147483647Response
The lead after the change.