Bulk send

The same message to a list of numbers in a single request — announcements, notices, campaign blasts.

POSThttps://api.mobilesasa.com/v1/send/bulk

Parameters

FieldTypeRequiredDescription
senderIDstringYesAn approved sender ID on your account.
phonesstringYesComma-separated list of recipients, e.g. "0712000001,0733000002,254700000003". Formats can be mixed.
messagestringYesThe text every recipient gets.
curl -X POST https://api.mobilesasa.com/v1/send/bulk \
  -H "Authorization: Bearer $MOBILESASA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "senderID": "MOBILESASA",
    "phones": "0712000001,0733000002,0700000003",
    "message": "Our offices will be closed on Monday for the public holiday."
  }'

Response

json
{
  "status": true,
  "responseCode": "0200",
  "message": "Accepted for delivery"
}

Behaviour details

  • Invalid numbers are skipped, not fatal — the valid remainder still sends. Clean your list first if you need all-or-nothing semantics.
  • Balance covers the whole batch up front. If credits can't cover every valid recipient you get 0402 and nothing sends.
  • Duplicates within the list are deduplicated, and the daily duplicate rule applies per recipient.
  • Blacklisted (opted-out) numbers are excluded automatically.

Very large lists

The endpoint comfortably takes thousands of numbers per call. Beyond that, batch your list into chunks of ~5,000 and space the calls — or talk to us about SMPP, which is built for sustained high throughput.