---
title: "Send a one-way SMS (admin only)"
method: POST
path: "/push/sms/v1"
tags: ["sms"]
---

# Send a one-way SMS (admin only)

`POST /push/sms/v1`

Sends a one-way (push) SMS. This endpoint is restricted to admin users with `Conversations Write` permission. Recipients cannot reply to one-way SMS. Phone numbers must be in E.164 format.

**Permission:** Admin status **and** `Conversations Write` required.

**Monitoring:** No impact.

## Request body

- BodyOnewaySms
  - `from_alphanum` string — Brand name that was created in your dashboard and validated by Ringover
  - `to_number` integer — International number format (E.164)
  - `content` string
  - `user_id` integer

## Response `200`

One-way SMS successfully sent.

- ResponseOnewaySms
  - `mdr_uuid` string

## 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.
- `403` — Forbidden — this endpoint requires admin privileges.
- `415` — Unsupported media type — use `application/json` content type.
- `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)