Delete audience

View as Markdown
Delete a specific audience by its ID. Users can only delete audiences they created. **400 is returned if the audience is used by an active campaign:** `"can't delete audience, campaign with this audience <id> exists"` Remove the campaign first, then retry deletion. On success, `data` is always an empty array `[]`.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired
The unique identifier of the audience to delete

Response

Audience deleted successfully
statusboolean
datalist of any

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
500
Internal Server Error