SMS Senders

Retrieve approved SMS senders for your account.

List SMS Senders

Get all approved SMS senders available for creating SMS templates.

GET /api/v1/sms-senders

Response

[
  {
    "id": 42,
    "senderId": "MyBrand"
  },
  {
    "id": 43,
    "senderId": "Alerts"
  }
]

Response Fields

Field	Type	Description
id	integer	SMS sender ID (use in SMS templates)
senderId	string	Alphanumeric sender name (max 11 characters)

Example

cURL

curl -X GET https://api.transformify.mk/api/v1/sms-senders \
  -H "X-API-Key: your-api-key"

JavaScript

const response = await fetch('https://api.transformify.mk/api/v1/sms-senders', {
  headers: {
    'X-API-Key': 'your-api-key'
  }
});

const senders = await response.json();
console.log(senders);
// [{ id: 42, senderId: 'MyBrand' }, ...]

Python

import requests

response = requests.get(
    'https://api.transformify.mk/api/v1/sms-senders',
    headers={'X-API-Key': 'your-api-key'}
)

senders = response.json()
for sender in senders:
    print(f"ID: {sender['id']}, Sender: {sender['senderId']}")

Usage

When creating an SMS template, use the id from this endpoint as the smsSenderId:

{
  "name": "My SMS Template",
  "templateContent": "Hello {{name}}!",
  "smsSenderId": 42
}

Notes

• Only approved SMS senders are returned
• SMS senders are registered and approved via the Dashboard (Channels → SMS)
• The senderId is the alphanumeric name that appears on recipients' phones (max 11 characters)
• When an SMS template with smsSenderId is used to create a campaign, the sender flows to the campaign automatically

Errors

Status	Error	Description
401	Unauthorized	Invalid API key