Overview

Current plan
—
Sent this month
0 / —
Sent all-time
0

Getting started

New here? Four steps take you from an empty account to your first delivered SMS.

Create an API key

Generate a key to authenticate requests from your backend.

Go to API keys →

Pair your phone

Install the Android app and scan a one-time pairing code.

Set up a device →

Send a test

Fire a message from the dashboard to confirm delivery works.

Send a test SMS →

Watch delivery

Call POST /api/v1/sms/send and track each message.

View messages →

Your profile

API keys

Use the key as an X-API-Key header on POST /api/v1/sms/send.

NameKeyStatusCreated

Android devices

How to register a phone

Your Android phone is the transmitter — it sends every message over its own SIM. Pair one to get started.

Install the app

Install the SMS Gateway app on the Android phone that will send the messages.

Register the phone

Tap + Register phone above to generate a one-time pairing code and QR.

Scan to pair

In the app open Settings → Scan QR and scan the code (or type it in manually).

Keep it running

Leave the phone on power with a SIM that has an SMS plan. It turns online once connected.

Pairing codes are shown only once. Remove a phone anytime to stop it receiving messages.

Your phones

Devices paired to your account. Status updates automatically.

LabelStatusBatteryLast seen

Send a test SMS

Recent messages

ToBodyStatusCreated

Billing & plan

Current plan

Plan
—
Used this month
0 / —
Remaining
—

Plan limits

—
—
—

Developer API

Send SMS from any app with one authenticated HTTP request. First create a key in API Keys, then send it as the X-API-Key header. Every send counts toward your plan's monthly quota.

Base URLhttps://sms.heliossend.com
EndpointPOST /api/v1/sms/send
Auth headerX-API-Key: sk_live_...

Request body

FieldTypeReq.Description
recipient_phonestringYesE.164 number, e.g. +15551234567.
bodystringYes*Message text; supports {{placeholders}}. *Send body or template_id.
template_idstringYes*ID of a saved template, rendered with variables.
variablesobjectNoValues substituted into {{...}} placeholders.
recipient_namestringNoExposed as {{name}} in the message.
idempotency_keystringNoDedupe retries; a repeat returns the original message.
sim_slotnumberNoSIM to send from on a dual-SIM phone (default 0).

cURL

curl -X POST https://sms.heliossend.com/api/v1/sms/send \
  -H "X-API-Key: $SMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_phone": "+15551234567",
    "recipient_name": "Ada",
    "body": "Hi {{name}}, your code is {{code}}",
    "variables": { "code": "429100" }
  }'

Node.js

const res = await fetch("https://sms.heliossend.com/api/v1/sms/send", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.SMS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    recipient_phone: "+15551234567",
    body: "Your order has shipped!",
  }),
});
const data = await res.json(); // { status: "QUEUED", message_id: "..." }

Python

import os, requests

requests.post(
    "https://sms.heliossend.com/api/v1/sms/send",
    headers={"X-API-Key": os.environ["SMS_API_KEY"]},
    json={
        "recipient_phone": "+15551234567",
        "recipient_name": "Grace",
        "body": "Hi {{name}}!",
    },
)

Response

# 202 Accepted
{ "status": "QUEUED", "message_id": "a1b2c3d4", "rendered_body": "Hi Grace!" }

Status & error codes

CodeMeaning
202Queued and dispatched to your phone.
200Idempotent hit (same idempotency_key as a prior request).
400Missing recipient_phone, or neither body nor template_id.
401Missing X-API-Key header.
403Invalid or revoked key, or the account is suspended.
404template_id not found.
429Monthly SMS quota reached for your plan.