SMS API

Send SMS from your own app or website

Use your ByteLine API key to connect websites, school portals, ERP systems, customer apps, and other internal tools to bulk SMS sending.

GET

/api/sms/api/account

Get wallet balance, approved sender IDs, and active pricing tiers.

GET

/api/sms/api/sender-ids

List sender IDs available for API sending.

POST

/api/sms/api/send

Send SMS to one or more recipients from your own system.

Authentication

Create an API key from your dashboard, then send it in the x-api-key header.

x-api-key: btl_live_********************************

Send example

curl -X POST https://api.bytelinetechnologies.com/api/sms/api/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "senderId": "Byteline",
    "message": "Hello from your app",
    "recipients": ["233546706933"],
    "clientReference": "invoice-1001"
  }'

Response shape

{
  "campaignId": "...",
  "campaignStatus": "sent",
  "totalRecipients": 1,
  "estimatedCost": 0.04,
  "senderId": "Byteline",
  "pricing": {
    "unitCost": 0.04
  }
}