We use cookies to personalise content and ads, to provide social media features and to analyse our traffic. We also share information about your use of our site with our social media, advertising and analytics partners who may combine it with other information that you’ve provided to them or that they’ve collected from your use of their services.Learn more about who we are, how you can contact us and how we process personal data in our Privacy Policy.
Send Message
Base URL:
POST: https://api.smsgatewayapi.com/v1/message/send
| Parameter | Input | Description | |
|---|---|---|---|
| client_id | API client ID | Login and go to 'Advanced' - 'API authentication' to find the API keys | Required |
| client_secret | API client secret | Login and go to 'Advanced' - 'API authentication' to find the API keys | Required |
| message | message | the message to be sent | Required |
| to | destination number | the number(s) that will receive the message in international format (eg: 324xx, 316xx, ...) | Required |
| sender | sender | The number or name of the sender. A number can't be longer than 14 characters.A name can't be longer than 11 characters and can't contain special characters | Required |
| date | Date and time the message will be sent | Format: yyyy-MM-dd HH:mm. If not provided, the message will be sent as soon as possible | Optional |
| reference | custom reference | String of max. 255 characters | Optional |
| test | true/false | The system will check all parameters but will not send an SMS message (no credits/balance used). | Optional |
| subid | id of a subaccount | If specified, the message will be sent from the subaccount. | Optional |
<?php //PHP - cURL $ch = curl_init(); $url = "https://api.smsgatewayapi.com/v1/message/send"; $client_id = "XXX"; // Your API client ID (required) $client_secret = "YYY"; // Your API client secret (required) $data = [ 'message' => "Hello World", //Message (required) 'to' => "32495123456", //Receiver (required) 'sender' => "YourName" //Sender (required)
]; curl_setopt($ch, CURLOPT_URL, "$url"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_VERBOSE, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-Client-Id: $client_id", "X-Client-Secret: $client_secret", "Content-Type: application/json", ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); $response = curl_exec($ch); ?>
Example request single receiver:
{
"message": "Hello World",
"to": "{nr}",
"date":"2024-01-01 15:30",
"sender": "YourName"
}
Example response single receiver:
{
"messageid": "h2md1ewkyzjkuyn9ak7pryw1evtyw3x"
}
Example request multiple receivers:
{
"message": "Hello World",
"to": ["{nr1}", "{nr2}"],
"sender": "YourName"
}
Example response multiple receivers:
{
"messageids": [
"h2md1ewkyzjkuyn9ak7pryw1evtyw3x",
"678rjqhrjwg3r7t78te1yxfda9u3yt6"
]
}
Exceptions:
Our system processes the messages in UTF8 and generates this in GSM unicode.
There are 9 characters that are counted as 2 characters in GSM unicode.
If you use one of these characters in your message, your message will be longer.
Example: If you have a message of 160 characters and you used a €-characters then the message real length is 161 characters long
| Symbol | Name | Symbol | Name | Symbol | Name |
|---|---|---|---|---|---|
| € | Euro symbol | \ | Backslash | } | Right brace |
| [ | Open bracket | ^ | Caret | ~ | Tilde |
| ] | Close bracket | { | Left brace | | | Vertical bar |