---
title: "Send SMS"
method: POST
path: "/v2/send-sms"
tags: ["SMS"]
---

# Send SMS

`POST /v2/send-sms`

Send an SMS message to a phone number. Messages are sent via the Surge SMS API and queued for delivery.

## Request body

- SendSmsRequest
  - `from_number` string — Sender phone number in E.164 format. Optional — defaults to your account's Surge phone number if not provided.
  - `to_number` string, required — Recipient phone number in E.164 format.
  - `message` string, required — The text message to send. Must not be empty.

## Response `201`

SMS queued for delivery

- SendSmsResponse
  - `id` string — Unique message identifier.
  - `from_number` string — The phone number the message was sent from.
  - `to_number` string — The phone number the message was sent to.
  - `message` string — The message body that was sent.
  - `status` 'queued' — The delivery status of the message.

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `422` — Validation error - Invalid phone number format or unsupported destination
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/openmicai/apis/openmic-v1-external-api.md) · [All operations](https://skmtc.net/openmicai/apis/openmic-v1-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmicai/openmic-v1-external-api/revisions/71c32e6ffd95/schema)