Send Message
Base URL:POST: https://api.smsgatewayapi.com/v1/message/send
Parameters:
| Parameter | Input | Description | |
|---|---|---|---|
Required | client_id | API client ID | Can be found with your API documentation |
Required | client_secret | API client secret | Can be found with your API documentation |
Required | message | message | The message to be send. |
Required | to | destination number | The number that will recieve the message |
Required | sender | sender | The number or name that of the sender. A number can't be longer than 14 characters and a name can't be longer than 11 characters and can't contain special characters |
Optional | date | Date and time the number will be send | Format: yyyy-mm-dd hh:mm. If not provided the message will be send as soon as possible |
Optional | reference | custom reference | string of maximum 75 characters |
Optional | type | type | If the value is "group", the "to" param will be a group ID instead of a phone number |
Optional | test | true/false | The system will check all parameters but will not send an SMS message. This will not use any credits. Becauce the request can be an array, the api also accepts test as a get parameter |
Optional | subid | id of a subaccount | If provided, the message will be send from the subaccount |
{
"message": "Example",
"to": "{nr}",
"date":"2019-10-15 15:30";,
"sender": "11111111111"
}
{
"message": "Example",
"to": "{group ID}",
"type": "group",
"date":"2019-10-15 15:30";,
"sender": "11111111111"
}
There are two ways to send multiple messages using one api call:
Note: a single sms can't have multiple types
[
{
"message": "Example one",
"to": "{nr}",
"sender": "11111111111",
"reference": "t_97"
},
{
"message": "Example two",
"to": "{other nr}",
"sender": "11111111111"
}
]
{
"message": "Example",
"to": ["{nr}", "{other nr}"],
"sender": "11111111111"
}
[
{
"message": "Example one",
"to": ["{nr}", "{other nr}"],
"sender": "11111111111"
},
{
"message": "Example two",
"to": "{Group ID}",
"type": "group",
"sender": "11111111111"
}
]
Example outputs:
Note: when you pass a singe message with an array as "to" but that array has only one number, the api will return the single message response.
{
"messageid": "h2md1ewkyzjkuyn9ak7pryw1evtyw3x"
}
{
"messageids": [
"h2md1ewkyzjkuyn9ak7pryw1evtyw3x",
"678rjqhrjwg3r7t78te1yxfda9u3yt6"
]
}
{
"messageid": "h2md1ewkyzjkuyn9ak7pryw1evtyw3x",
"test": true
}
Our system proccesses the messages in UTF8 and generates this in CELLPHONE unicode. There are 9 characters which counted as 2 characters in GSM unicode.
If you use one of these characters in your message, your message will be in fact longer. There can be errors because of this.
Example: If you have a message of 160 characters and you used two €-chacters then the message real length is 162 characters long
| Name | Name | Name | |||
|---|---|---|---|---|---|
| € | Euro symbol | \ | Backslash | } | Right brace |
| [ | Open bracket | ^ | Caret | ~ | Tilde |
| ] | Close bracket | { | Left brace | | | Vertical bar |