Skip to main content
DELETE
/
contacts
/
{contact_id}
Delete Contact
curl --request DELETE \
  --url https://api.clemta.com/contacts/{contact_id}
{
  "success": true,
  "message": "<string>",
  "data": {}
}

​
Authentication

This endpoint requires authentication using an API key. Include your API key in the request header: 
X-API-Key: your_api_key_here
See Authentication for more details.

​
Path Parameters

​
contact_id
string
required
The unique identifier of the contact to delete.

​
Response

​
success
boolean
Indicates if the request was successful.
​
message
string
Response message.
​
data
object
No data returned for delete operation (null).

​
HTTP Response Codes

CodeDescription
200Contact deleted successfully
400Invalid request
401Unauthorized - Invalid or missing API key
404Contact not found
500Internal server error

​
Error Response

When an error occurs, the API returns an error response: 
{
  "success": false,
  "message": "Contact not found",
  "data": null,
  "error": {
    "code": "NOT_FOUND",
    "details": ""
  }
}

​
Code Examples

curl -X DELETE https://api.clemta.com/contacts/64b8f1a2e4b0c8d9f0123456 \
  -H "X-API-Key: your_api_key_here"

​
Example Response

{
  "success": true,
  "message": "Contact deleted successfully",
  "data": null
}

​
Important Notes

Deleting a contact is a permanent action and cannot be undone. Make sure you want to delete the contact before proceeding.
When a contact is deleted, any references to this contact in other parts of the system may be affected. Consider archiving or deactivating contacts instead of deleting them if you need to maintain historical records.

Build docs developers (and LLMs) love

Get started for freeTalk to us