Audiences
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 |
Headers
| Name | Type | Description | Status |
|---|---|---|---|
| X-Dexatel-Key | string | API key | Required |
Request Body
-empty-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 | 'data.name' is invalid |
| 1305 | 'data.name' is too long |
| 1306 | 'data.channel' is missing |
| 1307 | 'data.channel' should be in: [SMS, WHATSAPP, VIBER] |
| 1308 | 'data.contacts' must be at most [10] items in length |
| 1309 | Audience already exists |