Skip to main content
POST
/
api
/
messaging
/
sms
/
send
{
  "recipient": "+255614853618",
  "message": "Hello, this is a test message",
  "sender_id": "MIFUMO"
}

{
  "success": true,
  "message": "SMS sent successfully",
  "data": {
    "message_id": "550e8400-e29b-41d4-a716-446655440000",
    "recipient": "+255614853618",
    "message": "Hello, this is a test message",
    "sender_id": "MIFUMO",
    "status": "queued",
    "cost": 0.05,
    "currency": "USD",
    "sent_at": "2025-11-27T10:30:00Z"
  }
}
Send a single SMS message.
​
recipient
string
required
Recipient phone number in E.164 format
​
message
string
required
SMS message content
​
sender_id
string
required
Sender ID (must be approved)

​
Request Example

{
  "recipient": "+255614853618",
  "message": "Hello, this is a test message",
  "sender_id": "MIFUMO"
}

​
Success Response (201)

​
success
boolean
Operation success status
​
message
string
Success message
​
data
object
SMS message data
{
  "success": true,
  "message": "SMS sent successfully",
  "data": {
    "message_id": "550e8400-e29b-41d4-a716-446655440000",
    "recipient": "+255614853618",
    "message": "Hello, this is a test message",
    "sender_id": "MIFUMO",
    "status": "queued",
    "cost": 0.05,
    "currency": "USD",
    "sent_at": "2025-11-27T10:30:00Z"
  }
}

​
Error Response (402) - Insufficient Credits

{
  "success": false,
  "error": "Insufficient credits",
  "message": "You need 1 credit to send this message. Current balance: 0 credits",
  "required_credits": 1,
  "current_balance": 0
}