HTTP API Keys

HTTP API keys authenticate requests to the SMS Platform API at sms.esmsafrica.io. Live keys start with esms_live_; test keys start with esms_test_ and simulate delivery without charging your wallet.

Get your API key

1. Log in to sms.esmsafrica.io
2. Go to Settings → API keys
3. Create a key and copy it (shown once)

Using the key

Pass the key as a Bearer token:

Authorization: Bearer esms_live_your_api_key

Example

curl -X POST https://sms.esmsafrica.io/api/messages/send \
  -H "Authorization: Bearer esms_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+254712345678",
    "text": "Hello!",
    "sender_id": "eSMS"
  }'