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
- SMS Pricing — Check per-country rates
- Contact Lists — Set up bulk SMS campaigns
- Delivery Reports — Track message delivery