Actions22
- Client Actions
- Message Channel Actions
- Sale Actions
- Lead Actions
Lead → Update Lead Status
AI-generatedSummary
Update the status of a specific lead by setting a new status ID and a descriptive note.
Inputs
- Lead ID (required) — The numeric ID of the lead to update (minimum value 1).
- Lead Status ID (required) — The numeric ID of the new status to assign to the lead (minimum value 1).
- Description (required) — A textual description or notes explaining the status change.
Output shape
a single updated lead status confirmation object
The operation sends a PUT request to the '/oportunidades/{Lead ID}/estado/{Lead Status ID}' endpoint with the description in the request body. It returns the API's response indicating the success or failure of the status update. No pagination or batch processing applies to this operation.
Examples
Example 1: Change a lead's status with explanatory notes
Set 'Lead ID' to 123, 'Lead Status ID' to 10, and provide a meaningful description explaining why the status changed.