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
string
required
The unique identifier of the audience to archive.
Response Fields
boolean
Whether the audience was archived successfully.
boolean
Confirms the audience has been archived. Always
true on success.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