Actions56
- Lead Actions
- Lead Activity Actions
- Lead Custom Field Actions
- Lead Note Actions
- Lead Segment Actions
- Lead Source Actions
- Lead Status Actions
- Lead Tag Actions
- Task Actions
Lead → Update
AI-generatedSummary
Update an existing lead identified by Lead ID with specified values using either form parameters or a raw JSON body.
Inputs
- Lead ID (required) — Unique identifier (UUID v7) of the lead to update.
- Body Type (required) — Choose the format for the update payload: 'form' to specify fields individually or 'json' to provide a raw JSON object.
- Body (JSON) — Raw JSON object representing the lead fields to update. Shown when 'Body Type' is set to 'json'.
- First Name — Lead's first name. Used if 'Body Type' is 'form'.
- Last Name — Lead's last name. Used if 'Body Type' is 'form'.
- Email — Lead's email address. Used if 'Body Type' is 'form'.
- Mobile Number — Lead's mobile number. Used if 'Body Type' is 'form'.
- Status Name or ID — Status of the lead identified by name or ID. Loaded dynamically. Used if 'Body Type' is 'form'.
- Source Name or ID — Source of the lead identified by name or ID. Loaded dynamically. Used if 'Body Type' is 'form'.
- Owner Name or ID — Owner of the lead identified by name or ID. Loaded dynamically. Used if 'Body Type' is 'form'.
- Tag IDs — List of tag IDs to assign to the lead. Multiple tags can be specified. Used if 'Body Type' is 'form'.
- Custom Fields — Custom field values to set on the lead, specified as key-value pairs. Used if 'Body Type' is 'form'.
- Updated At — ISO 8601 timestamp with timezone indicating when the lead was updated. Used if 'Body Type' is 'form'.
- Include Empty Fields (Compatibility) — If true, empty strings are sent for blank fields instead of omitting them. Used if 'Body Type' is 'form'.
- Additional / Undocumented Fields (JSON) — Raw JSON object with additional or undocumented fields to include in the update request. Used if 'Body Type' is 'form'.
Output shape
a single updated lead record object
The returned data includes the updated lead details. This operation requires specifying the Lead ID. When using the 'form' body type, only the provided fields are updated; others remain unchanged. Using 'json' body type allows full control over the update payload as a JSON object.