Skip to main content
POST
Delete audience
Use this endpoint to permanently delete audience records from a campaign.

Endpoint

POST /delete-audience Content-Type: application/json Authentication: Required (workspace auth)

Request Body

Delete specific audience

Delete all audience (draft campaigns only)

Response

When using delete_all:

Behavior

  • Hard deletes audience records — this action is irreversible.
  • When delete_all is true, all audience for the campaign are deleted. This is only allowed when the campaign is in draft status.
  • When delete_all is not set, audience array is required.
  • Only deletes records belonging to the specified campaign, company, and workspace.

Error Cases

Example cURL

Headers

token
string
required

API token for authentication

Body

application/json
campaign_id
integer
required

Campaign identifier

audience
integer[]

Array of audience record IDs to delete. Required when delete_all is not true.

delete_all
boolean

Set to true to delete all audience for this campaign. Only allowed when campaign is in draft status.

Response

Audience deleted successfully

message
string