# SMS

Send and receive SMS and MMS from your numbers with POST /v1/sms/messages, with US carrier registration handled through the API.

import { PlatformCapabilities } from '@/components/platform-capabilities';

Send and receive SMS and MMS from your [numbers](/platforms/phone-numbers) with `POST /v1/sms/messages`.

Replies land in the same [inbox](/messages/list-inbox-conversations) as your other channels and arrive as [`message.received`](/webhooks/inbox/message-received) events.

## Quick reference

In the US, a number needs an approved carrier registration to send, not to receive. Zernio runs that registration through the API.

<PlatformCapabilities rows={[
  { property: 'Message types', value: 'SMS (text) and MMS (media)' },
  { property: 'From', value: 'Any SMS-enabled number on your team, or an alphanumeric sender ID' },
  { property: 'Number format', value: 'E.164, normalized automatically' },
  { property: 'Replies', value: 'Thread into the inbox; message.received webhook' },
  { property: 'US requirement', value: 'Approved 10DLC or toll-free registration to send; none to receive' },
  { property: 'Registration reuse', value: 'One approval covers many numbers, with no repeat brand fee' },
  { property: 'Idempotency', value: 'Idempotency-Key header' },
]} />

## Before you start

SMS requires usage-based billing.

In the US, a number cannot send until its carrier registration (10DLC or toll-free) is approved. It receives from the moment SMS is on. Approval is asynchronous, so register early.

Every other country sends as soon as SMS is enabled on the number.

## How it fits together

1. Get an SMS-capable number. Not every number can text: [search](/platforms/phone-numbers/setup#step-1-search-available-numbers) with `sms=true`, purchase with `wantsSms: true`, or [port in](/platforms/phone-numbers/porting).
2. Enable SMS and register. Call `POST /v1/phone-numbers/{id}/sms`, then run the US [carrier registration](/platforms/sms/setup). An approved registration you already hold [covers the new number](/platforms/sms/setup#reuse-an-approval-skip-the-fee) with no repeat fee.
3. Send. [Send SMS or MMS](/platforms/sms/sending), respect opt-outs, and read replies in the inbox. For one-way international sends from a brand name instead of a number, use a [sender ID](/platforms/sms/sender-ids).

## Supported countries and pricing

You can send SMS to the destinations in the table below. Any other destination is blocked at send time.

How you reach a destination depends on what you send from:

| Send from | Reaches | Available in |
|---|---|---|
| An SMS-capable number | Recipients in the number's own country only (the US and Canada count as one) | Australia, Belgium, Canada, Lithuania, Netherlands, Poland, Puerto Rico, South Africa, Sweden, United Kingdom, United States, US Virgin Islands |
| A [sender ID](/platforms/sms/sender-ids) | Any destination below except the US, Canada and Puerto Rico, one-way, text only | No number needed |

Outbound SMS meters per segment at the rates below. They are "from" prices: the floor for that destination, since the exact price depends on the receiving carrier.

In the US, carrier fees put most messages at $0.015 to $0.017 per segment.

Inbound SMS is free on most numbers. Where the carrier charges an inbound fee (some US and Canadian routes), it bills at the metered per-segment rate.

Monthly number prices and US 10DLC registration fees are on [Phone pricing](/pricing/phone#sms).

<SmsRateTable />

<RatesGeneratedAt />

## In this section

<PlatformPages platform="sms" />

## Related

- [Send an SMS/MMS](/sms/send-sms): every field of the request.
- [Start a carrier registration](/sms/start-sms-registration): 10DLC and toll-free.
- [Add a number to an existing registration](/sms/reuse-sms-registration-for-number): reuse an approval.
- [List SMS opt-outs](/sms/list-sms-opt-outs): recipients who replied STOP.
- [Inbox webhooks](/webhooks/inbox): `message.received`, `message.delivered` and `message.failed`.