SMS Hub
v2.0 · inbound replies & delivery receipts

Send SMS through your own SIM cards

One REST API in front of Android phones you already own. Send OTPs and transactional alerts, receive inbound replies, and pay only your carrier plan rates.

POST /api/v1/messages200 OK
curl -X POST https://api.smshub.dev/api/v1/messages
  -H "Authorization: Bearer org_live_8f92a10b"
  -H "Content-Type: application/json"
  -d '{
    "to": "+251911223344",
    "content": "Your verification code is: 482910"
  }'

{ "id": "msg_tx3k9mqp1a", "status": "QUEUED" }

QUEUEDDISPATCHEDDELIVERED
SMS Hub · via gateway

Your verification code is:

482910

Gateway online · SIM activeDelivered in 1.2s
No per-SMS markup
Carrier plan rates only
Two-way messaging
Inbound via signed webhooks
Multi-device routing
Route by number or alias
SDKs included
TypeScript, Python, Go

API

Integrate in minutes

Use the SDK for your language, or plain HTTP requests against a predictable REST API.

import { SMSHubClient } from "@smshub/sdk";

const sms = new SMSHubClient({
  apiKey: process.env.SMSHUB_API_KEY,
});

const message = await sms.messages.send({
  to: "+251911223344",
  from: "dev_9x2k4m8p1q",
  content: "Your verification code is: 482910",
});

console.log(`Message queued with ID: ${message.id}`);
Simulatordevice: active
Output

Run a dispatch to see the API-to-gateway pipeline.

Features

What you get

Everything required to operate SMS as infrastructure: routing, delivery tracking, and access control.

Direct carrier routing

Messages are dispatched through local SIM cards on your own devices — no aggregator in the middle.

Two-way webhooks

Inbound replies and delivery receipts (SENT, DELIVERED, FAILED) are POSTed to your endpoints with HMAC signatures.

QR device pairing

Install the Android app, scan a QR code from the dashboard, and the device starts handling traffic immediately.

Scoped API tokens

Issue isolated keys per service with custom labels, and revoke them at any time without affecting other callers.

Multi-device routing

Pair as many gateways as you need and route traffic by phone number or alias across regions.

Delivery observability

Every message carries a full timeline: attempts, status transitions, error traces, and carrier timestamps.

Setup

How it works

From phone to production in three steps — no hardware to buy, no aggregator account.

  1. 01

    Install the gateway app

    Download the SMS Hub Android app onto any smartphone with an active SIM card.

  2. 02

    Scan the pairing QR

    Open your dashboard, add a device, and scan the generated QR code with the phone.

  3. 03

    Send and receive

    Call the REST API from your backend. Inbound messages arrive via webhook callbacks.

FAQ

Frequently asked questions

You install the SMS Hub Android service on any physical phone with an active SIM. Pairing happens by scanning an encrypted QR code from your dashboard. When you call the API, the payload is relayed to the paired phone and sent as a standard carrier SMS.

Get started

Turn a SIM card into a production SMS gateway

Create an organization, pair your first gateway, and dispatch your first message.