Before you start
You need an account, a balance and a list. The account takes an email address and a password; no identity documents, company papers or phone number are asked for. The balance is prepaid in USD and funded in cryptocurrency, with seven coins accepted. The list is a file with one phone number per row, ideally with a name column so the message can greet people.
Settle two questions first. Is this a notice the recipient expects, such as a delivery update or a reminder, or a promotion? That decides the timing rules and whether the text needs an opt-out. And has every number on the list agreed to hear from you about this? If you cannot say when and how each person opted in, fix that first; no campaign setting repairs a list.
Rates are published per destination and per segment, the same for every account, with no setup or monthly fee, so the cost is known before you fund anything: recipients, times segments per message, times each destination's rate.
Prepare the file
CSV, TXT or XLSX, up to 50 MB per file and up to 1,000,000 numbers per campaign. Put numbers in international format if you can, such as +447400123456; if not, tell the importer the default country and it converts them to E.164. Keep the columns you will use in the text and drop the rest. Do not clean duplicates by hand: the importer merges them after normalisation and tells you how many.
Three habits prevent most surprises:
- Format the phone column as text in your spreadsheet, so leading zeros and plus signs survive the export.
- Fill empty name cells with a neutral fallback such as there, so a greeting never renders with a gap in it.
- Remove everyone who opted out of earlier messages, whichever tool sent them.
Then read the import report: invalid rows with the reason (never sent, never billed), duplicates merged and a count per country. A list you thought was domestic that turns out to be a third foreign changes the sender plan and the cost; the guide to preparing a contact list has the details.
Choose the sender
The sender is what the phone shows as the origin of the message: an alphanumeric name of 3 to 11 characters (A to Z, digits and spaces), such as ACME or ACME SHOP. Whether recipients see it depends on the destination, which carries one of three rules:
- Alphanumeric delivered: the name is shown as typed, with no registration.
- Registration required: the name is shown only once it is registered with the operators; until then a shared numeric sender is used.
- Numeric sender: in the Americas and China, a local number is substituted, free of charge.
Set the name once and the rule is applied per destination; if a carrier refuses a name, that message falls back to a numeric sender and the report says so. Names are one-way, so where you need replies in a numeric-sender market, rent a dedicated number with inbound. Registration starts with a request from the sender settings in the panel: support prepares and submits the file where the destination accepts senders from abroad, at no fee, and approval takes days to weeks. The first campaign need not wait; the sender ID rules explain why countries differ.
Compose the message
Write the message as you would say it. Put your brand in the first words, because some countries show a number rather than your name. Then the point, then the action. Use {first_name} or any other column in braces. A typical promotion:
ACME: Hi {first_name}, the autumn sale starts today: 20% off all boots until Sunday. acme.example/boots Opt out: acme.example/stop
Rendered for Alexandra, that is 127 characters: one segment. Watch the counter: it shows the encoding, the segment count and the longest rendered row, which is the one that decides the cost. A single character outside GSM-7, typically a pasted curly apostrophe or an emoji, switches the whole message to Unicode, where one SMS holds 70 characters instead of 160. The composer names the character that forced the switch and offers one-click replacements for curly quotes, long dashes, the ellipsis character and special spaces; GSM-7 vs Unicode explains the arithmetic.
Put links on your own domain with a short path: public shorteners are the most filtered pattern in SMS and they hide your brand. A promotion also needs a way out: a STOP keyword where recipients can reply, or an opt-out link where they cannot.
Read the cost preview
The preview splits the campaign per destination at the public rate. Check three things: that the countries are the ones you expect, that invalid rows were removed for a reason you understand, and that the segment count is one unless you meant otherwise. Nothing has been charged at this point.
Billing happens message by message, when each one is handed to a carrier: messages refused before that point are rejected and never billed, while messages that reached a carrier and then failed are billed. The rate is locked for the life of the campaign, even one that runs over several days.
An example, with an illustrative rate of USD 0.02 per segment: 2,000 recipients and one segment cost USD 40. If a pasted apostrophe pushes a 150-character text into Unicode, it needs three segments and the same campaign costs USD 120. The preview is where that mistake is cheap to catch.
Test on your own phone
Before the real send, run the whole flow on a file of your own numbers: ideally one phone in each country that matters, on different operators. On each handset, check the sender against the destination's rule, the text for broken characters or empty placeholders, and the link. The report's from field records the sender actually used, so compare the two.
Through the API, a test key (sk_test_) validates, prices and answers like a live one, with the status test, and nothing is sent or billed. It shows how a message encodes and what it costs; only a real phone shows how it reads.
Pre-send checklist
- Every number agreed to receive this kind of message, and earlier opt-outs are out of the file.
- The import report is read: countries as expected, invalid rows understood, duplicates merged.
- Empty variables have a fallback, and the longest rendered row has been read in full.
- The sender name has 3 to 11 characters, and the brand opens the text.
- The encoding is GSM-7 unless you chose Unicode, and the segment count is the one you intended.
- Every link is on your own domain and opens on a phone.
- A promotion carries its opt-out and is scheduled in a local window, with default quiet hours left on.
- A pace is set if replies, calls or clicks land on a small team or a small site.
- The cost preview matches your estimate and the balance covers it.
- The test message arrived on your own phone and looked right.
Send or schedule
Send now for transactional notices. For anything promotional, schedule by local time: choose a window, for example 10:00 to 18:00, and the campaign opens in each country when its clock gets there. Each destination's default marketing window, shown on its country page, applies inside yours: France defaults to 08:00 to 20:00 and not on Sundays, so a campaign launched on a Sunday reaches French numbers on Monday. Messages not sent when a window closes wait for the next day's window.
Add a pace if replies land on a small team: a ceiling per minute, or a number of hours to spread the list over. A running campaign can be paused and resumed, which is the reason to watch the first minutes of a large send. Scheduling across time zones has the arithmetic.
Read the first report
Statuses arrive live. Give it an hour, then read the report in this order:
- Rejected. Refused before reaching a carrier, never billed, each with its error. A cluster usually points back at the file: a prefix or a format to fix before the next send.
- Failed, by reason. About twelve plain reasons, each with the raw carrier code. Unknown numbers will never deliver; absent subscribers had their phone off or out of coverage and are worth a later send; carrier filter blocks point at the sender or the content. The guide to why SMS fail covers every reason.
- Pending. Queued messages waiting for a window or the pace, and sent messages not yet confirmed. Receipts keep arriving as phones come back into coverage; after the validity period, 48 hours by default, what is left is marked expired.
- Delivered, per destination. Most destinations return handset receipts, where delivered means the phone got the message. A few give carrier acknowledgement only, and there sent is the final positive state; each country page says which. Compare destinations with that in mind.
Then read the sender column to see where your name was shown and where a number replaced it, and export the results as CSV or JSON if you want to keep them: per-message records are kept for 90 days, campaign summaries indefinitely. Remove unknown numbers with one click. You now have a cleaner list than the one you uploaded, which is the real result of a first campaign.
Before the second campaign
Delivery says the message arrived, not that it worked. Count what happened on your side: visits to the link, replies, orders or bookings within a fixed period after the send. Divide the campaign cost by those outcomes and you have the figure the next send has to beat; measuring campaign results shows how. Then change one thing, not five: the hour, the first words or the offer. Keep the cleaned list as your master copy, and start sender registrations for the markets you will send to regularly.
Something unclear or out of date? Tell us on the support page; corrections are folded back into the guide and the update date changes.
