SMS API v1

Powerful SMS messaging with bulk sending, status tracking, and comprehensive reporting

Authentication

Use Basic Auth with your API credentials encoded in base64:
Authorization: Basic base64(api_key:api_secret)
Get your API credentials from your Sendexa dashboard

Advanced Features

Send single messages, bulk campaigns, track delivery status, resend failed messages, and monitor usage

POST

/v1/sms/send

Core

Description

Send a single SMS message to any Ghana phone number with support for custom sender IDs, message segmentation, and real-time delivery tracking.

Supports all Ghana phone number formats
Automatic message segmentation (160 characters per segment)
Custom approved sender IDs
Real-time delivery status updates
Cost calculation based on message segments

Request Body

{
  "to": "0555539152",                    // Required: Ghana phone number
  "from": "YourBrand",                   // Required: Approved sender ID
  "message": "Hello from Sendexa!",      // Required: Message content
  
  // Legacy field support (optional)
  // "recipient": "0555539152",
  // "senderId": "YourBrand"
}

Response

{
  "success": true,
  "message": "SMS sent successfully",
  "data": {
    "id": "clxyz123abc",
    "messageId": "exa_api_123456789_abc123def",
    "externalId": "provider_12345",
    "status": "delivered",
    "cost": 1,
    "to": "233555539152",
    "from": "YourBrand",
    "timestamp": "2024-01-15T10:30:00.000Z",
    "segments": 1
  }
}

Examples

# Send single SMS
curl -X POST 'https://api.sendexa.co/v1/sms/send' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -d '{
    "to": "0555539152",
    "from": "YourBrand",
    "message": "Hello from Sendexa SMS API!"
  }'