Skip to main content
POST
Bulk Delete Contacts

Request

Deletion is permanent for the contact row and its direct properties. Associated activities, notes, and tasks are preserved in the timeline but lose their contact back-reference. To merge rather than delete, use POST /v1/contacts/merge.

Headers

string
Strongly recommended. The same key returns the original result within 24 hours.

Body Parameters

array
required
Array of contact UUIDs to delete. Maximum 500.
boolean
default:"false"
When true, the API validates input and returns counts but makes no changes.

Response

object
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID. Each successful deletion emits a contact.deleted webhook event.

Example Response

Errors