eSMS AfricaeSMS Africa
Guides

Send First SMS

Send your first SMS using the eSMS HTTP API.

Prerequisites

  • An eSMS account at app.esmsafrica.io
  • A funded wallet (top up via Billing)
  • Your HTTP API key (from your Profile)

Send the SMS

curl -X POST https://app.esmsafrica.io/api/sms/send \
  -H "X-Account-ID: your_account_id" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+254712345678",
    "text": "Hello from eSMS Africa!",
    "senderId": "eSMS"
  }'

Check delivery status

curl https://app.esmsafrica.io/api/sms/message/msg_abc123 \
  -H "X-Account-ID: your_account_id" \
  -H "X-API-Key: your_api_key"

Using Python

import requests

response = requests.post(
    "https://app.esmsafrica.io/api/sms/send",
    headers={
        "X-Account-ID": "your_account_id",
        "X-API-Key": "your_api_key",
        "Content-Type": "application/json",
    },
    json={
        "phoneNumber": "+254712345678",
        "text": "Hello from eSMS Africa!",
        "senderId": "eSMS",
    },
)

print(response.json())

Using Node.js

const response = await fetch('https://app.esmsafrica.io/api/sms/send', {
  method: 'POST',
  headers: {
    'X-Account-ID': 'your_account_id',
    'X-API-Key': 'your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phoneNumber: '+254712345678',
    text: 'Hello from eSMS Africa!',
    senderId: 'eSMS',
  }),
});

const data = await response.json();
console.log(data);

What's next

On this page