An audience is a group of contacts that can be targeted in the same campaign. The audiences and the contacts of the audiences are managed by the user through Audience API.

Audience endpoints are meant to control the audiences of the accounts.

Method: Delete

Operation deletes the audience.

URL /v1/audiences/{audience_id}
Method Type DELETE
Authorization API Key
Request Content-Type JSON
Response Content-Type JSON


Name Type Description Status
X-Dexatel-Key string API key Required

Request Body


Response Parameters

Example of request body

DELETE: /v1/audiences/22089fd7-7b74-4815-8452-3a8e864affbc
X-Dexatel-Key: 94d2f2f2884848bca861264ad86d8ace

Example of response body

status - 204

Error Codes

The following error codes are returned in response to a user’s request which contains bad syntax or cannot be fulfilled.

Code Description
1301 Audience is not found
1302 Invalid audience identifier
1303 'data.audience' name is required
1304 '' is invalid
1305 '' is too long
1306 '' is missing
1307 '' should be in: [SMS, WHATSAPP, VIBER]
1308 'data.contacts' must be at most [10] items in length
1309 Audience already exists