Keplars
Audiences

Delete audience

DELETE
/api/v1/public/audiences/delete-audience

Permanently deletes an audience. This action is irreversible. Requires audiences:manage scope.

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer token authentication. Use a Regular API key for email sending, or an Admin API key for marketing and automation endpoints.

Get your API keys from Settings → API Keys (regular) or Settings → Admin API Keys (admin) in the dashboard.

In: header

Query Parameters

id*string

Audience ID.

Formatuuid

Response Body

application/json

curl -X DELETE "https://api.keplars.com/api/v1/public/audiences/delete-audience?id=497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty
{
  "success": false,
  "error": "VALIDATION_ERROR",
  "message": "Field 'to' is required"
}