SMS API for websites, CMS and CRM systems.
With one integration you can handle registration confirmation, transactional messaging, OTP codes, scheduled sending and status delivery through callbacks.
Most commonly, SMS API integration is used in the following scenarios:
| Parameter | Description |
|---|---|
key |
Secret API key used to connect to the system. You can view and manage the key in company settings. |
brandID |
Unique sender brand ID in the system. |
numbers |
Comma-separated mobile numbers. Numbers must be in international format, without 00 and +. |
text |
Message text. Any Unicode characters are allowed. |
| Parameter | Description |
|---|---|
stopList |
stopList=false - disables stop-list checking. The message will be sent even if the recipient number is in the stop list. |
otp |
otp=true - SMS intended for one-time authorization codes (OTP / verification code).Sent with the highest priority. Use only during authentication flows. It must not be used for other message types. |
sendTime |
Scheduled message sending time. Format: Y-m-d H:i (for example: 2026-02-01 23:30) The specified time must be later than the current time. If this parameter is not provided, the message is sent immediately. |
SMS API allows you to automatically receive delivery status updates for sent messages on your server via the Callback mechanism.
When a message status changes (sent, delivered, failed, etc.), the system sends a GET request to your specified HTTPS endpoint.
| Parameter | Description |
|---|---|
key |
Callback validation key for your server. |
smsID |
Unique message identifier. |
number |
Recipient mobile number in international format. |
statusID |
Current message status code. |
date |
Status update timestamp (Y-m-d H:i:s). |
| statusID | Description |
|---|---|
0 |
Sent |
1 |
Delivered |
2 |
Failed |
3 |
Pending |
4 |
Error |
<?php
$key = $_GET['key'] ?? null;
$smsID = $_GET['smsID'] ?? null;
$number = $_GET['number'] ?? null;
$statusID = $_GET['statusID'] ?? null;
$date = $_GET['date'] ?? null;
// Validation: make sure key matches your callback key
if ($key !== 'YourCallbackKey') {
http_response_code(403);
echo 'Forbidden';
exit;
}
// Process the received status in your system here
http_response_code(200);
echo 'OK';
?>
The callback will be considered successful if your server returns an HTTP 200โ299 status code.
Use SMS API to quickly send messages from your system, manage delivery statuses and automate communication with your users.