---
title: "Send an SMS"
method: POST
path: "/push/sms"
tags: ["sms"]
---

# Send an SMS

`POST /push/sms`

Sends an SMS message. Phone numbers must be in E.164 format. If you are concerned about your consumption, please refer to "<a href='https://www.ringover.com/support/texting-understanding-and-ontrolling-usage'>SMS: understand and control your consumption</a>".

**Permission:** `Conversations Write` required.

**Monitoring:** Optional. With Monitoring **OFF**, you can only send SMS from your own phone number. With Monitoring **ON**, you can send SMS from another team member's number using the `user_id_forced` parameter.

## Request body

- BodyPushSms
  - `archived_auto` boolean, nullable
  - `from_number` string — International number format (E.164)
  - `to_number` string — International number format (E.164)
  - `content` string
  - `user_id_forced` integer — (optional) force the userID of someone else in the team to send the SMS
  - `scheduled_at` string, date-time — (optional) schedule the SMS to be sent at a later date in UTC

## Response `202`

SMS accepted and queued for delivery.

- ResponsePushSms
  - `message_id` integer
  - `conv_id` integer

## Other responses

- `400` — Invalid request body — check phone number format (E.164) and required fields.
- `401` — Unauthorized — missing or invalid API token, or missing `Conversations Write` permission.
- `402` — Payment required — your SMS credit balance is insufficient.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)