RCS Business Messaging API

Send a branded RCS text message to a Ghana MSISDN. Local formats like 024XXXXXXX / 055XXXXXXX are normalised to 233… automatically.

curl -X POST 'https://api.sendexa.co/v1/rcs/send' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Basic YOUR_DASHBOARD_BASE64_TOKEN' \
  -d '{
    "to": "0244123456",
    "agentId": "AGT-SENDXA-GH",
    "type": "text",
    "text": {
      "body": "Hi Ama — your GHS 250.00 payment to Accra Mart was successful. Ref: TXN-78421."
    },
    "fallback": {
      "enabled": true,
      "channel": "sms",
      "from": "Sendexa",
      "message": "Hi Ama — payment of GHS 250.00 to Accra Mart succeeded. Ref: TXN-78421."
    }
  }'

{
  "success": true,
  "code": "RCS_ACCEPTED",
  "message": "RCS message accepted for delivery.",
  "requestId": "REQ-1782001100451",
  "timestamp": "2026-07-12T09:15:10.451Z",
  "data": {
    "messageId": "MSG-RCS-7c2a91f0-4e1b-4d88-9c3a-1f8e0b2d4a11",
    "channel": "rcs",
    "agentId": "AGT-SENDXA-GH",
    "message": {
      "to": {
        "address": "233244123456",
        "country": { "code": "GH", "name": "Ghana" },
        "network": "MTN"
      },
      "type": "text"
    },
    "delivery": {
      "status": "QUEUED",
      "rcsCapable": null,
      "fallback": {
        "enabled": true,
        "channel": "sms",
        "triggered": false
      },
      "submittedAt": "2026-07-12T09:15:10.451Z"
    },
    "billing": {
      "units": 1,
      "pricing": {
        "unitCost": 0.04,
        "totalCost": 0.04,
        "currency": "USD",
        "note": "RCS charged; SMS fallback billed only if triggered"
      }
    }
  }
}

An RCS agent is your brand identity on the RCS network — similar to a WhatsApp Business profile or an SMS sender ID, but with a logo, description, contact details, and verification state. You send with an agentId returned after registration.

Not every handset is RCS-capable. When fallback is enabled, Sendexa attempts RCS first. If the device or network cannot accept RCS, the message is automatically delivered as SMS using your approved sender ID — so banks, fintechs, and e-commerce brands never drop a critical notification.

• Fallback only bills the SMS unit when it is actually triggered.
• Status responses and webhooks indicate channel: "rcs" or channel: "sms".
• Provide a concise SMS body — rich card media cannot be reproduced over SMS.
• SMS sender ID rules still apply (3–11 alphanumeric, pre-approved).