Delete Contact

Permanently delete a contact from your workspace. The contact path parameter accepts either the contact UUID or the current workspace identity value.

Deletion Behavior

How contact lookup and deletion work

  • Pass the contact UUID or the workspace identity value to resolve the contact.
  • Email identity lookups are normalized before matching, so surrounding whitespace and letter casing do not affect the lookup.
  • A successful request permanently deletes the contact and returns an empty response body.
  • Associated comments, message events, delivery routes, messages, campaign executions, and segment membership records are deleted with the contact.
  • The resolved contact must belong to the workspace in the path.
DELETE
/v1/workspaces/:workspace/contacts/:contact

Permanently delete a contact by UUID or identity value

Path parameters

workspacestring Required

ID of your workspace

contactstring Required

Contact UUID or the current workspace identity value

Delete by UUID
curl -X DELETE https://api.leadpush.io/v1/workspaces/:workspace/contacts/:contact \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {token}"
Delete by Identity
curl -X DELETE https://api.leadpush.io/v1/workspaces/:workspace/contacts/person@example.com \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {token}"

Success and Errors

Expected outcomes for delete requests

  • Successful requests return an empty success response body.
  • The endpoint returns 404 if the contact path parameter does not resolve to a contact in the workspace.
  • The endpoint returns 403 if the resolved contact does not belong to the workspace in the path or the token does not have access to it.