Skip to main content

Delete Contact

Permanently delete a contact from your account.

Endpoint​

DELETE /api/v1/contacts/{id}

Headers​

X-API-Key: sk_live_your_api_key

Path Parameters​

ParameterTypeRequiredDescription
idstringYesContact ID

Example Request​

curl -X DELETE https://api.sendmator.com/api/v1/contacts/123e4567-e89b-12d3-a456-426614174000 \
  -H "X-API-Key: sk_live_your_api_key"

Example Response​

{
  "deleted": true,
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Error Responses​

Contact Not Found (404)​

{
  "statusCode": 404,
  "message": "Contact not found",
  "error": "Not Found"
}

Important Notes​

⚠️ Warning: This action is permanent and cannot be undone.

  • All contact data will be permanently deleted
  • Contact will be removed from all email lists
  • Historical email data will be preserved but anonymized
  • Consider updating is_active to false instead if you need to preserve data