Move a lead to a stage
Move a lead to another stage, in any pipeline, or close it as Won or Lost.
POST https://cotlet.dev/api/v1/kommo/leads/{lead_id}/stage/move
write Confirm
Returns the lead with its new stage. The expected revenue of the pipeline updates by itself. A Digital Pipeline trigger on the target stage fires, so it can send an email, start a Salesbot or add a task. A closed lead leaves the pipeline view. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| lead_id integer required | integer | Lead ID from list_leads or get_lead. |
| stage_id integer | integer | Target stage from list_pipelines. Leave out when you use close_as. |
| close_as string | string | won or lost. Closes the lead the way dropping it on Won or Lost does. |
Request
curl -X POST https://cotlet.dev/api/v1/kommo/leads/1/stage/move \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("kommo", "move_lead_stage", {"lead_id":1})const result = await cotlet.call('kommo', 'move_lead_stage', {"lead_id":1});cotlet call kommo move_lead_stage --data '{"lead_id":1}'Example response
{
"lead_id": 24518301,
"from_stage": "Proposal",
"to_stage": "Negotiation",
"pipeline_id": 8210123
}