# Bulk SMS API | VeloBotix

> Send bulk SMS with SEND_BULK_SAME or SEND_BULK_DIFFERENT. Optional check_cost preview for same-message bulk.

Source: https://www.velobotix.app/docs/bulk-sms

Docs

# Bulk SMS

## SEND\_BULK\_SAME

Send the same message to multiple recipients. Pass senderID, to as an array of numbers, msg, and optionally check\_cost: true to preview cost first.

Portal examples use up to 10,000 numbers per request.

```
curl -X POST \
  "https://portal.velobotix.app/api.php?FUN=SEND_BULK_SAME" \
  -u "YOUR_EMAIL:YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderID":   "VeloBotix",
    "to":         ["0701234567", "0712345678", "0723456789"],
    "msg":        "Flash Sale! 50% off sitewide today only.",
    "check_cost": true
  }'
```

## SEND\_BULK\_DIFFERENT

Send personalised messages per recipient with msg\_list: an array of { to, msg } objects, plus senderID.

Portal examples use up to 20 unique messages per request.

```
curl -X POST \
  "https://portal.velobotix.app/api.php?FUN=SEND_BULK_DIFFERENT" \
  -u "YOUR_EMAIL:YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderID": "VeloBotix",
    "msg_list": [
      { "to": "0701234567", "msg": "Hi Amal! Order #1234 has shipped." },
      { "to": "0712345678", "msg": "Hi Nimal! Order #1235 is ready." },
      { "to": "0723456789", "msg": "Hi Kamal! Your invoice is due." }
    ]
  }'
```

## Parameters

Common and bulk-specific fields:

Parameter

Used with

Notes

senderID

Both

Approved Sender ID

to

SEND\_BULK\_SAME

Array of 07XXXXXXXX numbers

msg

SEND\_BULK\_SAME

Shared message body

check\_cost

SEND\_BULK\_SAME

Optional boolean — preview cost

msg\_list

SEND\_BULK\_DIFFERENT

Array of { to, msg }

## FAQ

Should I check cost before sending?

For SEND\_BULK\_SAME you can set check\_cost to true. Confirm the returned fields in your portal response before relying on them in automation.

## Create account

Sign up in the portal and get your API key — username is your email, password is the key.

[Open portal — get API key](https://portal.velobotix.app)