Channels and templates
List SMS sender IDs
Lists the SMS sender IDs that have been requested, with the status of each. A sender ID is the name shown instead of a number on the recipient's phone.
Requires: desk.read scope, Converse licence.
Authorization
bearerAuth AuthorizationBearer <token>
A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.
In: header
Query Parameters
cursor?string
next_cursor from the previous page. Leave it out for the first page.
limit?integer
Page size: 100 by default, 100 at most.
Response
OK
Example
{ "data": [ { "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37", "workspace_id": "0d16f37b-483b-4345-9876-083e209b25ee", "sender_id": "fd8c0bc1-a306-40ce-9f02-35bdd1443c8c", "use_case": "Order and delivery updates", "sample_message": "Hi Amina, your order has shipped.", "status": "open", "decision_note": "Approved", "requested_by": "01729983-8e9a-404e-93f5-c65f494454d9", "requested_at": "2026-10-14T08:30:00Z", "decided_at": "2026-10-14T08:30:00Z", "notified_at": "2026-10-14T08:30:00Z", "workspace_name": "Example Ltd", "requester_name": "Amina Wanjiru", "requester_email": "amina@example.com" } ], "next_cursor": "eyJvIjoyNX0", "has_more": false}FieldTypeDescription
datarequiredobject[]idrequiredstring (uuid)workspace_idrequiredstring (uuid)sender_idrequiredstringThe name that shows as the sender of your SMS, for example ACMEKE.use_caserequiredstringWhat you will use the sender ID for, in a sentence.sample_messagerequiredstringAn example of a message you would send with this sender ID.statusrequiredstringThe status to set.decision_notestringrequested_bystring (uuid) | nullrequested_atrequiredstring (date-time)decided_atstring (date-time) | nullnotified_atstring (date-time) | nullworkspace_namestringrequester_namestringrequester_emailstringnext_cursorrequiredstring | nullhas_morerequiredbooleancurl -X GET "https://api.sautidesk.com/v1/desk/sender-ids"