Delete a contact

Permanently delete a contact of the authenticated business, the same way Delete works on the Contacts page.

DELETE/contacts/:uuid

Authentication

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

ParameterTypeRequiredDescription
uuidStringRequiredUUID 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).