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
| Field | Type | Required | Description |
|---|---|---|---|
| senderID | string | Yes | An approved sender ID on your account. |
| phones | string | Yes | Comma-separated list of recipients, e.g. "0712000001,0733000002,254700000003". Formats can be mixed. |
| message | string | Yes | The 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.