Skip to main content
Remove a contact from your workspace.

​
Endpoint

DELETE /api/v1/{subdomain}/contacts/{id}
Required ability: contacts.delete.

​
Headers

HeaderValue
AuthorizationBearer apitk_...
Acceptapplication/json

​
Path parameters

​
subdomain
string
required
Your workspace subdomain.
​
id
integer
required
Contact id.

​
Example request

curl -X DELETE https://dash.xobito.com/api/v1/acme/contacts/451 \
  -H "Authorization: Bearer apitk_your_token_here" \
  -H "Accept: application/json"

​
Example response

200 OK
{
  "status": "success",
  "message": "Contact deleted successfully",
  "data": null
}

​
Error responses

StatusWhenExample body
401Missing / invalid token{"status":"error","message":"Invalid API token"}
403Missing ability{"status":"error","message":"Token does not have the required ability: contacts.delete"}
404Contact not found{"status":"error","message":"Contact not found"}
429Rate limit{"message":"Too many requests","retry_after":45}
500Server error{"status":"error","message":"Failed to delete contact"}
Delete is permanent. A deleted webhook fires for subscribers of contacts_actions.delete — see Webhook Events.