deleteLead
Permanently delete a lead by ID to remove unwanted spam or test entries. Irreversible; use updateLead to change status instead of removing the record.
Instructions
Delete a lead - Permanently delete a lead record by ID. Destructive - cannot be undone via API.
Use when: removing a spam or test lead. For preserving the lead but closing it, use updateLead with a status change instead.
Required: lead_id.
See also: updateLead (modify without removing).
Destructive: confirm intent with the user before bulk use. No soft-delete via API - records removed are not recoverable.
Returns: { status: "success", message: "record was deleted" }. No body beyond the confirmation string.
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": "deleteLead"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lead_id | Yes |