Send SMS

Send SMS for OTPs, alerts, or notices. Requests are queued; charges apply against your SMS balance (Get Account Balance).

Endpoint

POST https://api.bridgeagw.com/send_sms

Request Headers

Authorization: Basic <base64_encoded_credentials>
Content-Type: application/json

Request Body

{
  "service_id": 1,
  "customer_number": "0541234567",
  "msg_body": "Verification code: 091878",
  "sender_id": "MMDA"
}

Parameters

Parameter	Type	Required	Description
`service_id`	integer	Yes	Your service identifier
`customer_number`	string	Yes	Recipient phone number
`msg_body`	string	Yes	Message text
`sender_id`	string	Yes	Approved sender ID (max 11 characters)

Response

Success (queued)

{
  "response_message": "SMS request has been received for processing",
  "response_code": "370"
}

Error Examples

{
  "response_message": "Invalid phone number",
  "response_code": "400"
}

{
  "response_message": "Insufficient SMS balance",
  "response_code": "402"
}

Example (cURL)

curl -X POST "https://api.bridgeagw.com/send_sms" \
  -H "Authorization: Basic <your_credentials>" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 1,
    "customer_number": "0541234567",
    "msg_body": "Verification code: 091878",
    "sender_id": "MMDA"
  }'

Notes

Use E.164-style numbers without spaces (e.g. Ghana 054…).
Keep content concise; comply with local SMS rules.

Send SMS

On this page