SMS API, SMS app, SMS service, SMS sending

SMS API Interface

SMS API for websites, CMS and CRM systems.

REST API

What capabilities do you get?

With one integration you can handle registration confirmation, transactional messaging, OTP codes, scheduled sending and status delivery through callbacks.

Integration Website / CMS / CRM
Method REST API
Sending OTP / Bulk / Scheduled
Statuses Callback
SMS API integration, sms api, sms developers

Use Cases

Most commonly, SMS API integration is used in the following scenarios:

  • User registration confirmation linked to a specific mobile number via SMS
  • Bank account transaction notifications
  • Sending order status updates, promotions, new product alerts and any type of SMS advertising

How to Get Started

Log In

Top Up Balance

Activate API Service

Send Message

Send Message

https://api.ubill.dev/v1/sms/send?key=0123456789&brandID=1&numbers=995511194242,995511194242&text=message

Required Parameters

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.

Optional Parameters

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.

Automatically Receive Message Statuses (Callback)

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.

Callback URL Requirements

  • The URL must start with https://
  • Method: GET
  • The callback URL is configured in company settings

GET Request Example

https://example.com/callback?key=YourCallbackKey&smsID=12345678&number=995511194242&statusID=1&date=2026-02-01 12:02:02

Returned Parameters

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).

Status Meanings

statusID Description
0 Sent
1 Delivered
2 Failed
3 Pending
4 Error

Callback Handling Example (PHP)

<?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.

Ready for integration?

Use SMS API to quickly send messages from your system, manage delivery statuses and automate communication with your users.

Infrastructure & Technologies

We use leading and reliable technologies

uBill is built on modern tools that ensure stability, security, and seamless scalability

Back to top