Overview
Getting started
New here? Four steps take you from an empty account to your first delivered SMS.
Your profile
API keys
Use the key as an X-API-Key header on POST /api/v1/sms/send.
| Name | Key | Status | Created |
|---|
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.
| Label | Status | Battery | Last seen |
|---|
Send a test SMS
Recent messages
| To | Body | Status | Created |
|---|
Billing & plan
Current plan
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.
Request body
| Field | Type | Req. | Description |
|---|---|---|---|
| recipient_phone | string | Yes | E.164 number, e.g. +15551234567. |
| body | string | Yes* | Message text; supports {{placeholders}}. *Send body or template_id. |
| template_id | string | Yes* | ID of a saved template, rendered with variables. |
| variables | object | No | Values substituted into {{...}} placeholders. |
| recipient_name | string | No | Exposed as {{name}} in the message. |
| idempotency_key | string | No | Dedupe retries; a repeat returns the original message. |
| sim_slot | number | No | SIM 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
| Code | Meaning |
|---|---|
| 202 | Queued and dispatched to your phone. |
| 200 | Idempotent hit (same idempotency_key as a prior request). |
| 400 | Missing recipient_phone, or neither body nor template_id. |
| 401 | Missing X-API-Key header. |
| 403 | Invalid or revoked key, or the account is suspended. |
| 404 | template_id not found. |
| 429 | Monthly SMS quota reached for your plan. |