Send Message

The response contains a messageid per receiver, which you can use to track the message afterwards via Get message by ID (GET /v1/message/{messageid}).

Base URL:

POST: https://api.smsgatewayapi.com/v1/message/send

Parameter	Input	Description
client_id	API client ID	Login and go to 'Developer' - 'API & Webhooks' - 'API-credentials' to find the API keys	Required
client_secret	API client secret	Login and go to 'Developer' - 'API & Webhooks' - 'API-credentials' 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' => "31681234567", //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);
?>

//NodeJs - HTTP request			
const https = require("https");
const client_id = "XXX"; // Your API client ID (required)
const client_secret = "YYY"; // Your API client secret (required)
const data = JSON.stringify({
    message: 'Hello World', //Message (required)
    to: '31681234567', //Receiver (required)
	    sender: 'YourName', //Sender (required)
	

});
const options = {
    hostname: "api.smsgatewayapi.com",
    port: 443,
    path: "/v1/message/send",
    method: "POST",
    headers: {
        "X-Client-Id": client_id,
        "X-Client-Secret": client_secret,
		"Content-Type": "application/json",
		"Content-Length": data.length,
    },
};
const req = https.request(options, (res) => {
    console.log(`statusCode: ${res.statusCode}`);
    res.on("data", (d) => {
        process.stdout.write(d);
    });
});
req.write(data);
req.end();

//Ruby - Net::HTTP			
require "uri"
require "net/http"

url = URI("https://api.smsgatewayapi.com/v1/message/send")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Client-Id"] = "XXX" // Your API key
request["X-Client-Secret"] = "YYY" // Your API secret
request["Content-Type"] = "application/json"
form_data = [
	['message', "Hello World"], //Message (required)
	['to', "31681234567"], //Receiver (required)
		['sender', "YourName"] //Sender (required)
	

]
request.set_form form_data, 'multipart/form-data'
response = https.request(request)
puts response.read_body

//Python - Requests			
import requests
url = "https://api.smsgatewayapi.com/v1/message/send"
payload={
	'message' : 'Hello World', #Message (required)
	'to' : '31681234567', #Receiver (required)
		'sender' : 'YourName' #Sender (required)
	}
headers = {
	'X-Client-Id': 'XXX', #Your API key
	'X-Client-Secret': 'YYY', #Your API secret
	'Content-Type': 'application/json'
}
response = requests.request(
	"POST",
	url,
	headers=headers,
	json=payload
)
print(response.text)

//PowerShell - RestMethod
$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("X-Client-Id", "XXX") // Your API key
$headers.Add("X-Client-Secret", "YYY") // Your API secret

$body = '{
	"to": "31681234567", //Message (required)
	"message": "Hello World", //Receiver (required)
		"sender": "YourName" //Sender (required)
	

}'

$response = Invoke-RestMethod 'https://api.smsgatewayapi.com/v1/message/send' -Method 'POST' -Headers $headers -Body $body -ContentType “application/json; charset=utf-8”
$response | ConvertTo-Json

//Shell - wget
wget --no-check-certificate --quiet \
  --method POST \
  --timeout=0 \
  --header 'X-Client-Id: XXX' \ // Your API key
  --header 'X-Client-Secret: YYY' \ // Your API secret
  --header 'Content-Type: application/json' \
  --body-data '{
	"message" : "Hello World", //Message (required)
	"to" : "31681234567", //Receiver (required)
		"sender" : "YourName" //Sender (required)
	

}' \
   'https://api.smsgatewayapi.com/v1/message/send'

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

API

Guides

Messages

Voice

WhatsApp Business

Groups

Contacts

Outbox

Account

Sender IDs

Teammate/Subaccount

Conversations

Message Templates

Birthday Message

Opt-out

Other

Webhooks (v2)

Send Message

SMS gateway API

REGISTREER NU

Verken

Contacteer ons voor al uw vragen.

Algemene vragen

Verkoopvragen

Supportvragen

Bel ons

Contacteer ons voor al uw vragen.

Algemene vragen

Verkoopvragen

Supportvragen

Bel ons

BLOG