Delete audience contacts
Audience
Delete Audience Contacts
Soft-delete one or more contacts by contact ID, scoped to the caller’s company/workspace. No audience_id is required; every affected audience’s contact count is resynced.
POST
Delete audience contacts
Use this endpoint to soft-delete one or more contacts by contact ID.
Endpoint
POST/audience/delete-contacts
Content-Type: application/json
Authentication: Required (workspace auth)
Request Body
Response
Behavior
- Soft delete — sets the contact’s status to deleted; records are not removed from the database.
- Scoped to the caller’s company and workspace only — no
audience_idis needed, and contact IDs outside the caller’s scope, or already deleted, are silently skipped. - Every audience whose contacts were affected has its denormalized contact count resynced.
- Any pending dial rows for the deleted contacts are halted immediately (they will not be called even if already queued).
Error Cases
Example cURL
Headers
API token for authentication
Body
application/json

