Skip to main content
DELETE
This endpoint allows you to delete a contact from your organization. Review the contact ID before making the request.

Use Cases

  • Remove obsolete or duplicate contact records
  • Comply with data retention policies
  • Clean up your contact database

Path Parameters

string
requerido
The unique identifier of the contact to delete. This is a UUID string that was generated when the contact was created.

Headers

string
requerido
Your API key for authentication. You can find this in your dashboard under API settings.

Response

number
200 on success.
boolean
true when deletion is accepted.

Error Codes

  • 400 Bad Request - Invalid contact ID format
  • 401 Unauthorized - Invalid or missing API key
  • 404 Not Found - Contact not found
  • 500 Internal Server Error - Server-side error

Code Examples

Notes and Best Practices

  • Confirm the contact ID before deleting a contact
  • Consider implementing a “soft delete” in your application by flagging contacts as inactive instead of permanently deleting them
  • Keep audit logs of deleted contacts for compliance purposes
  • Ensure you have proper error handling for failed deletion attempts
  • If you’re deleting contacts as part of a bulk operation, implement rate limiting to avoid API throttling