Specification
API URL
The URL used to send the HTTP requests:
https://portal.bulkgate.com/api/1.0/simple/transactional
Supported methods
It is strictly prohibited to exploit transactional SMS for promotional/marketing uses. It must be used for notification purposes only - as an SMS notification.
Parameters table
PARAMETER NAME | VALUE | MANDATORY | DEFAULT VALUE |
---|---|---|---|
application_id | Application indentificator | Yes | - |
application_token | Application authentication token | Yes | - |
number | Recipient number | Yes | - |
text | Text of SMS message (max. 612 characters, or 268 characters if Unicode is used), UTF-8 encoding | Yes | - |
unicode | Yes /true /1 for Unicode SMS, no /false /0 for 7bit SMS | No | false |
sender_id | Sender ID, viz sender ID type | No | gSystem |
sender_id_value | Sender value - gOwn (e.g. "420 777 777 777"), gText (e.g. "BulkGate"), gProfile (e.g. "423"), gMobile or gPush (KEY) | No | null |
country | Provide the recipients' numbers in an international format (with prefix, e.g. 44 ) or add the country code in ISO 3166-1 alpha-2 format (7820125799 + GB = 447820125799 ). See the country example request. If null, your set timezone will be used to fill the information | No | null |
schedule | Schedule the sending time and date in unix timestamp, or ISO 8601. | No | Now |
duplicates_check | Select on to prevent sending duplicate messages to the same phone number. Messages with the same text sent to the same number will be removed if there is a time interval shorter than 5 minutes. If off no duplicates will be removed. | No | off |
tag | Message label for subsequent retrieval of the user. | No | - |
sender_id
Sender ID type VALUE | DESCRIPTION |
---|---|
gSystem | System number |
gShort | Short Code |
gText | Text sender |
gMobile | Mobile Connect |
gPush | Mobile Connect push - Sends a notification to the Mobile Connect app |
gOwn | Own Number (number verification required) |
gProfile | BulkGate Profile ID |
<int> | BulkGate Profile ID |
Response to this command may be:
In case of success:
{
"data": {
"status": "accepted",
"sms_id": "tmpde1bcd4b1d1",
"price": 0.02,
"credit": 215.81380,
"number": "447700900000"
}
}
In case of error:
{
"type": "invalid_phone_number",
"code": 400,
"error": "Invalid phone number",
"detail": null
}
{
"type": "unknown_identity",
"code": 401,
"error": "Unknown identity / unauthorized / empty application_id",
"detail": null
}
Where:
- type and error (description of the error) can be found in the error types table,
- code represents http error
- detail is an additional info about the error
See all the error types for Simple API and Advanced API here.