Send Batch SMS Messages

This document will describe how to send batch SMS messages.

Batch messages allows you to send up to 1,000 messages per Batch SMS request. These are useful for large campaigns.

POST /send/batch

Send batch SMS messages to a number of receipients.

Curl

curl -X POST "https://api.mobivatebulksms.com/send/batch" \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer [API KEY]' \
-d '{
  "routeId": "mglobal",
  "scheduleDateTime": "2024-08-01T10:00:00+0200",
  "excludeOptouts": false,
  "excludeDuplicates": false,
  "spreadHours": 0,
  "recipients": [
    {
      "reference": "ref-001",
      "text": "This is a test message with full options",
      "routeId": "mglobal",
      "originator": "Brand",
      "recipient": "440000001"
    }
  ],
  "shortenUrls": false,
  "name": "August Campaign"
}'

Python

Please note, to schedule a date time as a parameter, the date time parameter must be set to a time in the future.

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer [Api-Key]

Body

Name	Type	Required?	Description
routeId	string	Yes	Route for messages.
name	string	No	Campaign name, used for reporting purposes.
shortenUrls	boolean	No	Default: false (URLs will not be shortened) Set to true to shorten long URLs Reduces message size and allows click tacking.
excludeOptouts	boolean	No	Default: true (Optouts are excluded) Set to false to turn off Optout filtering.
excludeDuplicates	boolean	No	Default: true (Duplicates are excluded) Set to false if you wish to send multiple messages to the same recipient(s).
scheduleDateTime	datetime	No	Default: null (Campaign is sent immediately) Specify a date/time to schedule delivery at a later date Example: 2024-01-26T15:30:00+0530
spreadHours	integer	No	Default: 0 (Spread the campaign over X hours) Specify a number of hours to spread the campaign over.
recipients	list	Yes	List of recipients to send the batch of SMS messages to. See arguments below.

Arguments

Recipient arguments are largely the same as when sending a single SMS message, see here.

Name	Type	Required?	Description
originator	string	Yes	Originator/SenderID for SMS messages (MaxLength - AlphaNumeric: 11, numeric: 15).
recipient	string	Yes	Recipient of SMS Message (Numeric only, MSISDN format inc international prefix).
text	string	Yes	Message text.
routeID	string	No	Specified message route.
reference	string	No	Your reference, will be provided as part of the delivery receipt for correlation.

Response

200

{
    "id": "4dbe11c6bda241e394889f2f3cc66cf8",
    "name": "August Campaign",
    "routeId": "mglobal",
    "shortenUrls": false,
    "spreadHours": 0,
    "excludeOptouts": false,
    "excludeDuplicates": false,
    "scheduleDateTime": "2024-08-01T08:00:00+0000",
    "recipients": [
        {
            "originator": "Brand",
            "recipient": "440000001",
            "text": "This is a test message with full options",
            "reference": "ref-001",
            "routeId": "mglobal"
        }
    ]
}

401