Sending Bulk SMS via Unifonic API
To send Bulk SMS messages using Unifonic REST API, you will need an application ID (AppSid) and a registered sender.
The URL is: 'https://el.cloud.unifonic.com/rest/Messages/SendBulk', and the method is 'POST'
In the API petition, you have to include the following parameters:
Parameter | Description | Value |
---|---|---|
AppSid | Authentication string that uniquely identifies your application. | 6v253153s1g7831s5 |
SenderID | The SenderID identifies who has sent the SMS message; in case of not adding this parameter, the system will use the default SenderID | Sender |
Recipient | Destination mobile number, mobile numbers must be in international format without 00 or +, and the multiple recipients mus be separated by comas. | 966505980169,966507679351 |
Body | Message body that will be send to all recipients. | Welcome to Unifonic |
responseType | Support JSON format only | JSON |
CorrelationID | Unique identifier value that is attached to requests and messages. | CorrelationID |
baseEncode | Binary-to-text encoding schemes that represent binary data in an ASCII string format | true |
statusCallback | Filter messages report according to a specific message status, "Sent", "Queued", "Rejected" or "Failed | sent |
async | It specifies that the request will be executed asynchronously as soon as it is sent | false |
API petition examples:
curl --location --request POST 'https://el.cloud.unifonic.com/rest/Messages/SendBulk?AppSid=SLNyz7qGpqJC0s5vid2EuC9P7sn4GO&SenderID=Unifonic&Body=Welcome to unifonic&Recipient=971507679351,971501694301&responseType=JSON&CorrelationID=q1&baseEncode=true&statusCallback=sent&async=false' \
--header 'Accept: application/json'
API response example:
{
"success": "true",
"message": "",
"errorCode": "ER-00",
"data": {
"Messages": [
{
"MessageID": 54000136852969,
"Recipient": "971507679351",
"Status": "Queued"
},
{
"MessageID": 54000136852970,
"Recipient": "971501694301",
"Status": "Queued"
}
],
"NumberOfUnits": 0,
"Cost": 0,
"Balance": 0,
"TimeCreated": "2022-09-12 10:37:16.696",
"CurrencyCode": ""
}
}
Updated 5 months ago