Skip to main content
DELETE
Eliminar un cliente
Deletes a customer from your CRM. The deletion is permanent — there is no soft-delete flag and no restore endpoint.
This is not reversible. If you only want to stop contacting someone, set accepts_marketing to false with PATCH /v1/crm/customers/:id instead of deleting the record.

Endpoint

Required scope

crm:customers:delete This is a separate scope from crm:customers:write on purpose — an integration that keeps customer data in sync should be able to create and update without being able to destroy.

Headers

Path parameters

Example request

Response

204 No Content

The customer was deleted. The response body is empty.

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the crm:customers:delete scope.

404 Not Found

No customer with that id, or the customer belongs to a different company.

Operational notes

  • Tickets and notes are not cascaded. Deleting a customer leaves any related tickets and notes in place, since they are attached to the chat user rather than to the customer record.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Response

204

Cliente eliminado