Sending SMS
The Send SMS endpoint is the primary API for sending messages immediately.
⚡
Messages sent through this endpoint are delivered immediately. For delayed delivery, use the Schedule SMS endpoint.
Endpoint
POST /api/send-smsRequest Body
| Field | Type | Required | Description |
|---|---|---|---|
senderId | string | Yes | Approved sender ID (max 11 characters) |
phone | string | Yes | A single phone number or comma-separated numbers |
message | string | Yes | Message content (max 918 characters for long SMS) |
The senderId must belong to the same account as the API key and be active.
Requests using a sender ID that is not owned by the API key will be rejected.
Request Example
{
"senderId": "MyBusiness",
"phone": "233200000000,233201111111,233202222222",
"message": "Hello from our platform! Your order #12345 has been shipped."
}Response
Success Response
HTTP/1.1 200 OK{
"success": true,
"messageId": "msg_abc123xyz789",
"phone": "233200000000,233201111111,233202222222",
"status": "sent"
}Response Fields
| Field | Type | Description |
|---|---|---|
success | boolean | Whether the request was successful |
messageId | string | Unique identifier for tracking |
phone | string | Phone number(s) submitted |
status | string | sent, queued, or failed |
Phone Number Format
We support Ghana phone numbers in international format (with or without +)
and local format. Numbers are normalized automatically before sending.
| Format | Valid | Example |
|---|---|---|
| International (no +) | ✅ | 233200000000 (Ghana) |
| With + prefix | ✅ | +233200000000 |
| Local format | ✅ | 0200000000 |
Message Length
| Type | Characters | Credits |
|---|---|---|
| Standard SMS | 1-160 | 1 |
| Long SMS (2 parts) | 161-306 | 2 |
| Long SMS (3 parts) | 307-459 | 3 |
| Maximum | 918 | 6 |
💡
Tip: Keep messages under 160 characters when possible to minimize credits used.