Bulk SMS API Nigeria

Powerful REST API for developers to integrate bulk SMS into their applications. Complete documentation with code examples in multiple languages.

Ready-to-Use Code Examples

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.

🐘 PHP Laravel 🐍 Python 🟢 Node.js 🌐 JavaScript 🔧 cURL 📮 Postman

Quick Start Guide

1

Sign Up & Get API Token

Register for free and get your API token instantly. No credit card required.

2

Choose Your Language

Use our code examples in PHP, Python, JavaScript, or cURL

3

Start Sending SMS

Make your first request and start sending bulk SMS

Base URL

All API requests should be made to the following base URL:

https://www.bulksmsnigeria.com/api

Authentication

Our API accepts authentication tokens in multiple ways for maximum flexibility. The recommended method is using the Authorization header:

RECOMMENDED

Authorization Header

Authorization: Bearer YOUR_API_TOKEN

Custom Header

api_token: YOUR_API_TOKEN

Query Parameter

?api_token=YOUR_API_TOKEN

Request Body

{"api_token": "YOUR_API_TOKEN"}

POST Send Bulk SMS

Send bulk SMS messages to one or multiple recipients across all Nigerian networks

Endpoints

/api/v2/sms Recommended
/api/v1/sms/create Legacy

Request Parameters

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

Code Examples

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."
  }'
<?php
$apiToken = 'YOUR_API_TOKEN';
$url = 'https://www.bulksmsnigeria.com/api/v2/sms';

$data = [
    'from' => 'YourCompany',
    'to' => '2347012345678,2348012345678',
    'body' => 'Hello from BulkSMS Nigeria API!'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiToken,
    'Content-Type: application/json',
    'Accept: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>
import requests
import json

api_token = 'YOUR_API_TOKEN'
url = 'https://www.bulksmsnigeria.com/api/v2/sms'

headers = {
    'Authorization': f'Bearer {api_token}',
    'Content-Type': 'application/json',
    'Accept': 'application/json'
}

data = {
    'from': 'YourCompany',
    'to': '2347012345678,2348012345678',
    'body': 'Hello from BulkSMS Nigeria API!'
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
const apiToken = 'YOUR_API_TOKEN';
const url = 'https://www.bulksmsnigeria.com/api/v2/sms';

const data = {
    from: 'YourCompany',
    to: '2347012345678,2348012345678',
    body: 'Hello from BulkSMS Nigeria API!'
};

fetch(url, {
    method: 'POST',
    headers: {
        'Authorization': `Bearer ${apiToken}`,
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));

Success Response

{
  "success": true,
  "message": "SMS sent successfully",
  "data": {
    "message_id": "msg_abc123xyz",
    "total_recipients": 2,
    "cost": 2.50,
    "balance": 497.50
  }
}

GET Check Account Balance

Check your current SMS credit balance

Endpoint

/api/v2/balance

Example Request

curl -X GET https://www.bulksmsnigeria.com/api/v2/balance \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Success Response

{
  "success": true,
  "data": {
    "balance": 500.00,
    "currency": "NGN"
  }
}

Ready to Integrate Our SMS API?

Sign up now and get your API token instantly. Start sending bulk SMS in minutes with 50 free SMS credits.

Why Choose Our Bulk SMS API?

Instant Delivery

Messages delivered in seconds with 99.9% uptime guarantee

All Networks

Deliver to MTN, GLO, Airtel, 9mobile including DND numbers

Affordable Rates

Starting from ₦5.62 per SMS with volume discounts