Delete an audience
DELETE/v1/audiences/{id}
Deletes the audience and its contacts. Refused while a broadcast to it is scheduled or sending, and for audiences that have already sent a broadcast, which are kept for your records.
Required scope: contacts:manage
Parameters
| Name | In | Description |
|---|---|---|
idrequired | path | The audience id. |
Example
curl -X DELETE 'https://api.sendsend.email/v1/audiences/ID' \
-H "Authorization: Bearer $SENDSEND_API_KEY"Response 200
{
"object": "audience",
"id": "xxx_…",
"deleted": true
}Errors
| Status | Code | When |
|---|---|---|
| 404 | not_found | No such resource in this project. |
| 409 | validation_error | A broadcast is still using it, or it has sent broadcasts. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 403 | forbidden | The key does not have the scope this endpoint needs. |
Every error has the same shape. See Errors.