API Documentation | BulkSMSHub SMS & WhatsApp REST API

Quick Start

Send your first SMS in under 5 minutes. Base URL: https://api.bulksmshub.com/v2

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key from your dashboard under Settings > API Keys.

Send a Single SMS

POST /sms/send
Authorization: Bearer YOUR_API_KEY
{
"to": "+971585527099",
"from": "YourBrand",
"message": "Your OTP is 847291. Valid for 5 minutes.",
"type": "transactional"
}
200 OK
{"message_id": "msg_a1b2c3d4", "status": "queued", "cost": 0.022}

Send Bulk SMS

POST /sms/bulk
Authorization: Bearer YOUR_API_KEY
{
"recipients": ["+971585527099", "+6512345678"],
"from": "YourBrand",
"message": "Hi {first_name}, your order {order_id} is confirmed!",
"personalisation": [{"first_name":"Ahmed","order_id":"12345"}, {"first_name":"Priya","order_id":"12346"}],
"scheduled_at": "2026-04-10T10:00:00+04:00"
}

Available Endpoints

Method	Endpoint	Description
POST	`/sms/send`	Send a single SMS message
POST	`/sms/bulk`	Send SMS to multiple recipients (max 50,000 per call)
GET	`/sms/{message_id}`	Get delivery status of a message
POST	`/sms/schedule`	Schedule SMS for future delivery
DELETE	`/sms/schedule/{id}`	Cancel a scheduled message
POST	`/contacts`	Create or update a contact
GET	`/contacts`	List contacts with filtering and pagination
POST	`/contacts/import`	Bulk import contacts from CSV
POST	`/lookup/hlr`	Number portability and carrier lookup
GET	`/account/balance`	Get remaining SMS credit balance
POST	`/webhooks`	Register webhook for delivery reports
POST	`/whatsapp/send`	Send WhatsApp template message

Available SDKs

🌤️

Python

pip install bulksmshub
Full async/await support. PyPI package.

💻

Node.js

npm install bulksmshub
Promise and callback API. TypeScript types.

🐘

PHP

composer require bulksmshub/sdk
PSR-4 autoloading. Laravel ready.

☕

Java

Maven and Gradle available.
Spring Boot integration guide included.

💎

Ruby

gem install bulksmshub
Rails integration. ActiveJob compatible.

🚀

Go

go get bulksmshub.com/go-sdk
Goroutine safe. Context support.

Webhooks

Receive real-time delivery reports and inbound message notifications via webhook. Register your endpoint in the dashboard or via the API:

// Delivery Report Webhook Payload
{"message_id":"msg_a1b2c3d4","to":"+971585527099","status":"delivered","delivered_at":"2026-04-08T09:42:17Z","latency_ms":843,"carrier":"Etisalat UAE"}

Webhook requests include HMAC-SHA256 signature in the X-BulkSMSHub-Signature header for verification.

Rate Limits

Starter plan: 10 req/sec. Professional: 100 req/sec. Business: 500 req/sec. Enterprise: custom. Rate limit headers included in every response: X-RateLimit-Remaining and X-RateLimit-Reset.

Support

API questions? Contact api@bulksmshub.com or join our developer community. Enterprise support includes dedicated solutions engineer and SLA-backed response times.

BulkSMSHub API Documentation