Skip to main content
DELETE
/
v2
/
audiences
/
{id}
curl -X DELETE "https://app.tracklysms.com/api/v2/audiences/664f1a2b3c4d5e6f7a8b9c0d" \
  -H "X-Api-Key: trk_your_api_key_here"

{
  "success": true,
  "archived": true
}
Archives the specified audience by setting its status to archived. This is a soft delete — the audience data is retained but will no longer appear in the default audience list. Archived audiences can be retrieved by passing status=archived to the List Audiences endpoint.

​
Path Parameters

​
id
string
required
The unique identifier of the audience to archive.

​
Response Fields

​
success
boolean
Whether the audience was archived successfully.
​
archived
boolean
Confirms the audience has been archived. Always true on success.

​
Examples

curl -X DELETE "https://app.tracklysms.com/api/v2/audiences/664f1a2b3c4d5e6f7a8b9c0d" \
  -H "X-Api-Key: trk_your_api_key_here"

{
  "success": true,
  "archived": true
}

​
Error Codes

HTTP StatusError CodeDescription
401unauthorizedAPI key is missing or invalid
404not_foundNo audience exists with the specified ID

​
Next Steps

Creating Audiences

Manage audience segments

Create Schedule

Schedule a campaign