Senders

The sender is the name displayed on your customers' phones.

• Shared sender: "Aureus Desk", used by default, available right away for every account.
• Own sender: reserved for organisations. A name of 2 to 11 letters, digits or single spaces, usable after approval by the operator (a few days). A single custom name per account: under review or approved.

List your senders

GET https://api.getaureusdesk.com/v1/sms/senders

[{ "id": "…", "name": "BOUTIQUEX", "status": "REJECTED", "rejectionReason": "Name already used by another brand.", "createdAt": "2026-11-01T10:00:00.000Z", "updatedAt": "2026-11-03T09:00:00.000Z" }]

status: PENDING (under review), APPROVED (usable) or REJECTED. A rejection carries its reason in rejectionReason and frees the slot for another name.

Request a sender

POST https://api.getaureusdesk.com/v1/sms/senders

{ "name": "BOUTIQUEX" }

201 response with PENDING status. Then send with "senderId": "BOUTIQUEX" once the name is approved; before that, sending is rejected (422 SENDER_NOT_APPROVED).