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>"
}
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