ShamaSMS API Documentation

<?php
$apiKey = "YOUR_API_KEY";
$payload = json_encode([
 "sender_id" => "MYAPP",
 "message" => "Hello @name@@, your balance is @var1@@.",
 "personalized"=> true,
 "recipients" => [
 ["phone" => "0700000000", "name" => "Alice", "var1" => "35,000"],
 ["phone" => "0750000001", "name" => "Bob", "var1" => "12,000"],
 ],
 "sandbox" => false,
]);
$ch = curl_init("https://shamasms.com/api/v2/sms/send");
curl_setopt_array($ch, [
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_POST => true,
 CURLOPT_POSTFIELDS => $payload,
 CURLOPT_HTTPHEADER => [
 "Content-Type: application/json",
 "Authorization: Bearer " . $apiKey,
 ],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
echo "Sent: " . $response["sent_count"] . ", Credits left: " . $response["balance"];

JavaScript (fetch)

const API_KEY = "YOUR_API_KEY";

const response = await fetch("https://shamasms.com/api/v2/sms/send", {
 method: "POST",
 headers: {
 "Content-Type": "application/json",
 "Authorization": `Bearer ${API_KEY}`,
 },
 body: JSON.stringify({
 sender_id: "MYAPP",
 message: "Hello @name@@, your order @var1@@ is ready!",
 personalized: true,
 recipients: [
 { phone: "0700000000", name: "Alice", var1: "ORD-1042" },
 ],
 sandbox: false,
 }),
});

const data = await response.json();
console.log(`Sent: ${data.sent_count}, Balance: ${data.balance}`);

Python (requests)

import requests

API_KEY = "YOUR_API_KEY"

resp = requests.post(
 "https://shamasms.com/api/v2/sms/send",
 headers={"Authorization": f"Bearer {API_KEY}"},
 json={
 "sender_id": "MYAPP",
 "message": "Hi @name@@, your invoice of UGX @var1@@ is due.",
 "personalized": True,
 "recipients": [
 {"phone": "0700000000", "name": "Alice", "var1": "150,000"},
 {"phone": "0750000001", "name": "Bob", "var1": "80,000"},
 ],
 "sandbox": False,
 }
)

data = resp.json()
print(f"Sent: {data['sent_count']}, Balance: {data['balance']}")

cURL (command line)

# Simple bulk send
curl -X POST https://shamasms.com/api/v2/sms/send \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer YOUR_API_KEY" \
 -d '{
 "sender_id": "SHAMA",
 "message": "Test message from ShamaSMS API.",
 "numbers": ["0700000000"],
 "sandbox": true
 }'

# Check balance
curl https://shamasms.com/api/v2/balance \
 -H "Authorization: Bearer YOUR_API_KEY"