Delete a contact
Permanently delete a contact of the authenticated business, the same way Delete works on the Contacts page.
DELETE
/contacts/:uuidAuthentication
This endpoint authenticates with your API key sent in the X-API-Key header (ek_live_... format). You can create it in Business settings → API Keys.
This cannot be undone. The contact is removed together with its conversations and messages, and the follow-ups scheduled for it are cancelled.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
uuid | String | Required | UUID of the contact to delete. |
Example request
bash
curl -X DELETE "https://api.eclecticlabs.com/api/external/v2/contacts/eb2b914a-977e-4ab8-96e7-b886698b3eac" \
-H "X-API-Key: ek_live_your_api_key_here"Example response
json
{
"success": true,
"contact_id": "eb2b914a-977e-4ab8-96e7-b886698b3eac"
}Notes
- If the contact is a duplicate, prefer POST /contacts/merge: it keeps the history, and the person keeps reaching the surviving contact.
- No request body is required.
- Possible errors: 401 (invalid or missing API key), 404 (contact not found in your business), 500 (the contact could not be deleted).