Update deal stage
Move a deal to another sales stage or pipeline.
MCP tool vtiger_write → update_deal_stage
write Confirm
Moves one deal like dragging it between columns of the Kanban view. With pipeline, it does what Change Pipeline does: pick the new pipeline and stage, and optionally the probability. A stage name your pipeline does not have fails, and the error lists the stages. Contacts can get emails from your Vtiger workflows when a stage changes. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| record_id string required | string | Deal record id from list_deals. |
| sales_stage string required | string | Target sales stage, named as in the pipeline. |
| pipeline string | string | Target pipeline, only to move the deal to another pipeline. |
| probability integer | integer | Probability in percent, optional. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "vtiger_write",
"arguments": {
"operation": "update_deal_stage",
"arguments": {
"record_id": "2041",
"sales_stage": "Negotiation",
"probability": 75
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"record_id": "2041",
"name": "Whitfield Dental, 5 seats",
"sales_stage": "Negotiation",
"pipeline": "Standard",
"probability": 75
},
"isError": false
}