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
Body
application/json

