---
title: "Opt a number out of SMS"
method: POST
path: "/sms/opt-out"
tags: ["sms"]
---

# Opt a number out of SMS

`POST /sms/opt-out`

Adds a phone number to your team's outbound SMS opt-out list. Any later attempt to send an SMS to that number is blocked, and nothing is charged.

Use this endpoint when a recipient unsubscribes through a channel other than a `STOP` reply — a phone call, an email, or a form on your website — so that your Ringover opt-out list stays aligned with your own database.

The team is taken from your API key, so it is not part of the payload. The number must be in international format (E.164), with or without the leading `+`; a national format such as `0612345678` is rejected. Opting out a number that is already opted out succeeds and changes nothing.

The opt-out is scoped to your team only. It has no effect on other Ringover accounts, does not block inbound SMS from that number, and is unrelated to the call blacklist.

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

**Monitoring:** No impact.

## Request body

- BodySmsOptOut
  - `phone_number` string, required — Number to opt out, in international format (E.164), with or without the leading +

## Response `200`

The number is opted out. The response has no body.

## Other responses

- `400` — Missing `phone_number`, or the number is not in international (E.164) format.
- `401` — Unauthorized — missing or invalid API token, or missing `Conversations Write` permission.
- `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)