Permanently removes a contact from your Customerly account. This action is irreversible
and will delete all associated data including:
- Contact profile and attributes
- Conversation history
- Event tracking data
- Notes and tags
⚠️ Warning: This action cannot be undone. Make sure you really want to delete this contact.
How to Identify the Contact to Delete
Use any of these identifier formats in the URL path:
1. Customerly Contact ID (numeric):
- Example:
DELETE /contacts/29911301 - The internal numeric ID from Customerly
2. Custom User ID (prefix: cuid:):
- Example:
DELETE /contacts/cuid:user_123 - Your own custom identifier for a registered user
3. Custom Lead ID (prefix: clid:):
- Example:
DELETE /contacts/clid:lead_456 - Your own custom identifier for a lead
4. WhatsApp Number (prefix: wa:):
- Example:
DELETE /contacts/wa:+1234567890 - Must include country code with + prefix (E.164 format)
5. Email Address (prefix: uem: or lem:):
- For registered users:
DELETE /contacts/uem:[email protected] - For leads:
DELETE /contacts/lem:[email protected] - You must know whether it's a user or lead
Response
- 204 No Content: Contact successfully deleted (empty response body)
- 404 Not Found: Contact doesn't exist
Example Requests
# Delete by Customerly ID
DELETE /contacts/29911301
# Delete user by custom user ID
DELETE /contacts/cuid:user_abc123
# Delete lead by custom lead ID
DELETE /contacts/clid:lead_xyz789
# Delete by WhatsApp number
DELETE /contacts/wa:+1234567890
# Delete user by email
DELETE /contacts/uem:[email protected]| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Contact successfully deleted. No content is returned in the response body.
Authentication credentials are missing or invalid. Please check your API key.
You don't have permission to delete contacts. Check your account permissions.
Contact not found. The identifier doesn't match any contact in your account. The contact may have already been deleted or never existed.
The contact is involved in an ongoing merge. Wait for the merge to complete before deleting it.