curl -X DELETE "https://api.tracklysms.com/api/v2/audiences/664f1a2b3c4d5e6f7a8b9c0d" \
-H "X-Api-Key: trk_your_api_key_here"
import requests
audience_id = "664f1a2b3c4d5e6f7a8b9c0d"
response = requests.delete(
f"https://api.tracklysms.com/api/v2/audiences/{audience_id}",
headers={"X-Api-Key": "trk_your_api_key_here"},
)
result = response.json()
if result["success"]:
print("Audience archived successfully")
const audienceId = "664f1a2b3c4d5e6f7a8b9c0d";
const response = await fetch(
`https://api.tracklysms.com/api/v2/audiences/${audienceId}`,
{
method: "DELETE",
headers: { "X-Api-Key": "trk_your_api_key_here" },
}
);
const result = await response.json();
if (result.success) {
console.log("Audience archived successfully");
}
{
"success": true,
"archived": true
}
{
"error": "Audience not found",
"code": "not_found"
}
{
"error": "Invalid credentials",
"code": "invalid_credentials"
}
Audiences (v2)
Delete Audience
Archive an audience (soft delete).
DELETE
/
v2
/
audiences
/
{id}
curl -X DELETE "https://api.tracklysms.com/api/v2/audiences/664f1a2b3c4d5e6f7a8b9c0d" \
-H "X-Api-Key: trk_your_api_key_here"
import requests
audience_id = "664f1a2b3c4d5e6f7a8b9c0d"
response = requests.delete(
f"https://api.tracklysms.com/api/v2/audiences/{audience_id}",
headers={"X-Api-Key": "trk_your_api_key_here"},
)
result = response.json()
if result["success"]:
print("Audience archived successfully")
const audienceId = "664f1a2b3c4d5e6f7a8b9c0d";
const response = await fetch(
`https://api.tracklysms.com/api/v2/audiences/${audienceId}`,
{
method: "DELETE",
headers: { "X-Api-Key": "trk_your_api_key_here" },
}
);
const result = await response.json();
if (result.success) {
console.log("Audience archived successfully");
}
{
"success": true,
"archived": true
}
{
"error": "Audience not found",
"code": "not_found"
}
{
"error": "Invalid credentials",
"code": "invalid_credentials"
}
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
Response Fields
Examples
curl -X DELETE "https://api.tracklysms.com/api/v2/audiences/664f1a2b3c4d5e6f7a8b9c0d" \
-H "X-Api-Key: trk_your_api_key_here"
import requests
audience_id = "664f1a2b3c4d5e6f7a8b9c0d"
response = requests.delete(
f"https://api.tracklysms.com/api/v2/audiences/{audience_id}",
headers={"X-Api-Key": "trk_your_api_key_here"},
)
result = response.json()
if result["success"]:
print("Audience archived successfully")
const audienceId = "664f1a2b3c4d5e6f7a8b9c0d";
const response = await fetch(
`https://api.tracklysms.com/api/v2/audiences/${audienceId}`,
{
method: "DELETE",
headers: { "X-Api-Key": "trk_your_api_key_here" },
}
);
const result = await response.json();
if (result.success) {
console.log("Audience archived successfully");
}
{
"success": true,
"archived": true
}
{
"error": "Audience not found",
"code": "not_found"
}
{
"error": "Invalid credentials",
"code": "invalid_credentials"
}
Error Codes
| HTTP Status | Error Code | Description |
|---|---|---|
| 401 | invalid_credentials | API key is missing or invalid |
| 403 | account_suspended | Your account is suspended. Resolve outstanding billing or contact support. |
| 404 | not_found | No audience exists with the specified ID |
Next Steps
Creating Audiences
Manage audience segments
Create Schedule
Schedule a campaign