Delete Contact: Permanently Remove a Contact Record

The Delete Contact endpoint permanently removes a contact and all associated records from your Workspace. This action is irreversible — the contact’s conversation history, custom field values, tags, and notes are deleted. Use this endpoint only when you intend a full removal; to simply block a contact from sending messages, use the block endpoint instead. A successful deletion returns HTTP 204 No Content.

DELETE /api/v1/contacts/{identifier}

Deleting a contact is permanent and cannot be undone. Verify the identifier resolves to the correct contact before sending this request.

Path Parameters

string

required

A contact lookup string using one of the three supported prefix formats. Minimum length: 1 character.

Format	Example
`id:<value>`	`id:123456789`
`email:<value>`	`email:user@example.com`
`phone:<value>`	`phone:+84708123123`

Code Examples

curl --request DELETE \
  --url "https://app.chatbotx.io/api/v1/contacts/email:user@example.com" \
  --header "Authorization: Bearer YOUR_API_TOKEN"

import requests

identifier = "email:user@example.com"
url = f"https://app.chatbotx.io/api/v1/contacts/{identifier}"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.delete(url, headers=headers)
print(response.status_code)  # 204 on success

const identifier = 'email:user@example.com';
const options = {
  method: 'DELETE',
  headers: { Authorization: 'Bearer YOUR_API_TOKEN' }
};

fetch(`https://app.chatbotx.io/api/v1/contacts/${identifier}`, options)
  .then(res => {
    if (res.status === 204) console.log('Contact deleted successfully');
  })
  .catch(err => console.error(err));

Response

A successful request returns HTTP 204 No Content with no response body.

HTTP/1.1 204 No Content

⌘I

Overview

Contacts

Custom Fields

Tags

Flows & Sequences

Broadcasts & Channels

Workspace

AI Agents

Delete Contact: Permanently Remove a Contact Record

Path Parameters

Code Examples

Response

​Path Parameters

​Code Examples

​Response

Path Parameters

Code Examples

Response