SimpleSMSDocs

Documentation

To get started with SimpleSMS you will need a sandbox API key, which is free and issued the moment you create an account. Every endpoint works in the sandbox, webhooks included.

Renamed from Delivered. SimpleSMS is the same API under a new name. The old domain, dsms_sk_ keys, dsms-signature headers, the deliveredsms package and DELIVERED_* environment variables all keep working. What changed and what did not.

Quickstart

Send your first SMS in under five minutes.

Authentication

API keys, test vs live mode, and key rotation.

Sandbox & test numbers

How test mode works, including magic numbers.

Messages

Send SMS, retrieve messages, and list history.

Verify

Phone verification (OTP) in two API calls.

Webhooks

Signed event delivery to your endpoint, with automatic retries.

Migrate from Twilio Verify

Line-by-line mapping from Twilio Verify to SimpleSMS Verify.

Numbers

Search, buy, organize, and release phone numbers, one at a time or hundreds at once.

Customers

Attribute numbers, messages, verifications and usage to the businesses you send for.

Lookup

Carrier and line type for any number.

Inbox & conversations

Threaded conversations, unread counts, and the shared team inbox.

Contacts

Contacts, CSV import, segments and subscription topics: in the console and the API.

Teams

Multiple users on one account: roles, email invitations, signatures.

Batches & broadcasts

One message to up to 10,000 people - from a CSV, the API, or tagged contacts - with per-recipient variables, pause, cancel and retry.

Scheduled messages

Send later: schedule 1:1 messages up to 30 days out.

Automations

Send events from your app; SimpleSMS sends, waits, and branches.

Auto-replies & office hours

Per-number automatic replies, optionally only outside business hours.

Number porting

Bring an existing business number to SimpleSMS.

Opt-out, consent & TCPA

Revocation in plain English, the consent ledger, and what is blocked.

Compliance & registration

Website disclosure check, generated opt-in copy, 10DLC brand and campaign registration, and opt-in proof.

Security best practices

Protect your account, API keys, and users: key hygiene, phishing awareness, and how we handle your data.

Deliverability

Delivery rates by day, carrier, and sending number, plus automatic degradation alerts.

Spend limits

A monthly cap on live messaging spend, with alerts as you approach it.

Audit log

Who changed keys, team, webhooks, spend limits, numbers, consent, and settings.

Errors

The error envelope and every error code.

Pricing

What SimpleSMS costs, and what the free tier includes.

Changelog

What changed in SimpleSMS.

For agents and tooling