---
title: "Send SMS (US)"
method: POST
path: "/v1/api/sms"
tags: ["SMS"]
---

# Send SMS (US)

`POST /v1/api/sms`

Send an SMS message to a US phone number using one of your Allo phone numbers. The recipient must be in the same country as your Allo number.

## Request body

- SendSMSRequest — Request body for sending an SMS message (US)
  - `from` string, required — Your Allo phone number (must be owned by your account)
  - `to` string, required — Recipient phone number (E.164 format, same country as 'from')
  - `message` string, required — Message content

## Response `200`

SMS sent successfully

- SendSMSResponse — Standard response wrapper for sent SMS
  - `data` TextMessageApiResponse — Sent SMS message details
    - `from_number` string, nullable — Phone number that sent the message. Null when sender_id is used instead.
    - `sender_id` string, nullable — Sender ID used for the message (alphanumeric identifier). Only populated when sending with a verified Sender ID (e.g., for France SMS). Null when from_number is used.
    - `to_number` string — Phone number that received the message
    - `type` 'OUTBOUND' — Direction of the message (always OUTBOUND for sent messages)
    - `content` string — Content of the SMS message
    - `start_date` string, date-time — When the message was sent

## Other responses

- `400` — Bad request
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - API key lacks required scope
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) · [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withallo/allo-api/revisions/9aab4db82933/schema)