curl -X POST "https://api.telzino.com/v1/organizations/234cd323-…/suppression-list" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "phone_number": "+15105550123", "reason": "opt_out", "notes": "Asked on 2026-09-30 call" }'
curl "https://api.telzino.com/v1/organizations/234cd323-…/suppression-list?page=1&limit=50" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"id": "9b8a7c6d-…",
"organization_id": "234cd323-…",
"phone_number": "+15105550123",
"reason": "opt_out",
"notes": "Asked on 2026-09-30 call",
"created_by": "api:My Reporting Tool",
"created_at": "2026-09-30T18:04:11.000Z"
}
{
"error": "suppressed",
"error_description": "+15105550123 is on the organization's outbound suppression list"
}
Suppression List
List / Add Suppression Entries
The organization’s outbound do-not-call list, checked before every outbound call
POST
/
v1
/
organizations
/
{organization_id}
/
suppression-list
curl -X POST "https://api.telzino.com/v1/organizations/234cd323-…/suppression-list" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "phone_number": "+15105550123", "reason": "opt_out", "notes": "Asked on 2026-09-30 call" }'
curl "https://api.telzino.com/v1/organizations/234cd323-…/suppression-list?page=1&limit=50" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"id": "9b8a7c6d-…",
"organization_id": "234cd323-…",
"phone_number": "+15105550123",
"reason": "opt_out",
"notes": "Asked on 2026-09-30 call",
"created_by": "api:My Reporting Tool",
"created_at": "2026-09-30T18:04:11.000Z"
}
{
"error": "suppressed",
"error_description": "+15105550123 is on the organization's outbound suppression list"
}
A number on an organization’s suppression list is never dialled by that organization’s agents: a trigger for it is refused with
409 suppressed. The list is per organization — a sibling organization under the same account can still call the number. See Outbound Compliance.
GET returns one page of entries. POST adds a number.
Path Parameters
string
required
The organization’s UUID
Query Parameters (GET)
integer
default:"1"
Page number
integer
default:"50"
Entries per page (max 100)
Request Body (POST)
string
required
E.164, e.g.
+15105550123. Matched exactly against the dialled number — no national-format or fuzzy matching.string
default:"manual"
One of
opt_out, manual, complaint, litigation, other.string
Up to 1000 characters — where the request came from, for example.
Adding a number that is already listed succeeds rather than erroring, so a do-not-call request is never lost to a duplicate. The author of an entry is taken from the API key, not from the request body.
curl -X POST "https://api.telzino.com/v1/organizations/234cd323-…/suppression-list" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "phone_number": "+15105550123", "reason": "opt_out", "notes": "Asked on 2026-09-30 call" }'
curl "https://api.telzino.com/v1/organizations/234cd323-…/suppression-list?page=1&limit=50" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"id": "9b8a7c6d-…",
"organization_id": "234cd323-…",
"phone_number": "+15105550123",
"reason": "opt_out",
"notes": "Asked on 2026-09-30 call",
"created_by": "api:My Reporting Tool",
"created_at": "2026-09-30T18:04:11.000Z"
}
{
"error": "suppressed",
"error_description": "+15105550123 is on the organization's outbound suppression list"
}
| Code | Meaning |
|---|---|
201 | Number suppressed (or already was) |
400 | Invalid body or phone number |
404 | Organization not found or access denied |