Skip to main content
POST
/
v1
/
contacts
/
leads
/
delete
Delete Contacts
curl --request POST \
  --url https://api.example.com/v1/contacts/leads/delete \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "lead_ids": [
    {}
  ],
  "group_id": "<string>"
}
'
{
  "success": true,
  "deleted_count": 123,
  "requested_count": 123,
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.teli.ai/llms.txt

Use this file to discover all available pages before exploring further.

Delete individual contacts by their unique IDs. Contacts are removed from their group and will no longer appear in the contacts list.
Uses POST instead of DELETE to support a JSON body with an array of contact IDs.

​
Authentication

​
X-API-Key
string
required
Your API key

​
Body

​
lead_ids
array
required
Array of contact unique_ids to delete. Maximum 1,000 per request.
["1771008017933x138393378469989770", "1771008017933x159634755314753624"]
​
group_id
string
Group unique_id. If provided, the group’s contact count is automatically updated.

​
Example Request

curl -X POST "https://api.teli.ai/v1/contacts/leads/delete" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_ids": [
      "1771008017933x138393378469989770",
      "1771008017933x159634755314753624"
    ],
    "group_id": "1771006759003x369396216299543784"
  }'

​
Response

​
success
boolean
Whether the request was successful
​
deleted_count
integer
Number of contacts successfully deleted
​
requested_count
integer
Number of contacts requested for deletion
​
message
string
Human-readable result message

​
Example Response

200
{
  "success": true,
  "deleted_count": 2,
  "requested_count": 2,
  "message": "2 contacts deleted",
  "powered_by": "Teli"
}

​
Notes

  • Maximum 1,000 contacts can be deleted per request
  • Contacts not found or already deleted are silently skipped
  • If group_id is provided, the group’s total_leads count is automatically decremented
  • Contacts are removed from all group memberships