Powerful REST API for developers to integrate bulk SMS into their applications. Complete documentation with code examples in multiple languages.
Skip the setup! Get complete, production-ready code examples in PHP, Python, JavaScript, Node.js, and more. Plus download our Postman collections to test instantly.
Register for free and get your API token instantly. No credit card required.
Use our code examples in PHP, Python, JavaScript, or cURL
Make your first request and start sending bulk SMS
All API requests should be made to the following base URL:
https://www.bulksmsnigeria.com/api
Our API accepts authentication tokens in multiple ways for maximum flexibility. The recommended method is using the Authorization header:
Authorization: Bearer YOUR_API_TOKEN
api_token: YOUR_API_TOKEN
?api_token=YOUR_API_TOKEN
{"api_token": "YOUR_API_TOKEN"}
Send bulk SMS messages to one or multiple recipients across all Nigerian networks
/api/v2/sms
Recommended
/api/v1/sms/create
Legacy
| Parameter | Type | Required | Description |
|---|---|---|---|
from |
string | Required | Sender ID (max 11 characters) |
to |
string | Required | Comma-separated phone numbers (e.g., 2347012345678,2348012345678) |
body |
string | Required | Message content (up to 1530 characters) |
gateway |
string | Optional | Gateway: direct-refund, direct-corporate, otp, dual-backup |
callback_url |
string | Optional | URL for delivery status callbacks/webhooks |
curl -X POST https://www.bulksmsnigeria.com/api/v2/sms \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"from": "YourCompany",
"to": "2347012345678,2348012345678",
"body": "Hello from BulkSMS Nigeria API! Welcome to our service."
}'
{
"success": true,
"message": "SMS sent successfully",
"data": {
"message_id": "msg_abc123xyz",
"total_recipients": 2,
"cost": 2.50,
"balance": 497.50
}
}
Check your current SMS credit balance
/api/v2/balance
curl -X GET https://www.bulksmsnigeria.com/api/v2/balance \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"
{
"success": true,
"data": {
"balance": 500.00,
"currency": "NGN"
}
}
Sign up now and get your API token instantly. Start sending bulk SMS in minutes with 50 free SMS credits.
Messages delivered in seconds with 99.9% uptime guarantee
Deliver to MTN, GLO, Airtel, 9mobile including DND numbers
Starting from ₦5.62 per SMS with volume discounts