delete_lead
Soft-delete a lead in Kommo CRM by setting is_deleted=true via PATCH /leads/{id}. Destructive: removes lead from normal lists; confirm lead_id first.
Instructions
Delete a lead. Sends PATCH /leads/{id} with is_deleted=true, so the lead is soft-deleted rather than removed through a hard-delete call. Destructive: the lead disappears from normal lists. Confirm the lead_id with get_lead first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"lead_id": "<lead_id>"
},
"name": "delete_lead"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lead_id | Yes | Kommo lead ID (integer). Obtain it from list_leads or from the create_lead result. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Lead ID. | |
| name | No | Lead name. | |
| price | No | Lead budget. | |
| _links | No | HAL links as returned by Kommo (self, next, ...). | |
| group_id | No | ID of the responsible user's group. | |
| _embedded | No | Embedded tags, contacts and companies. | |
| closed_at | No | Closing time, Unix seconds, or null. | |
| status_id | No | Current stage ID. | |
| account_id | No | Kommo account ID. | |
| created_at | No | Creation time, Unix seconds. | |
| created_by | No | ID of the user who created it. | |
| is_deleted | No | Whether the lead is deleted. | |
| updated_at | No | Last update time, Unix seconds. | |
| updated_by | No | ID of the user who last updated it. | |
| pipeline_id | No | Pipeline ID. | |
| loss_reason_id | No | Loss reason ID, or null. | |
| closest_task_at | No | Next task deadline, Unix seconds, or null. | |
| responsible_user_id | No | ID of the responsible Kommo user. | |
| custom_fields_values | No | Custom field values in Kommo format: objects with field_id, field_code and values. |