---
title: "Opt a number back in to SMS"
method: POST
path: "/sms/opt-in"
tags: ["sms"]
---

# Opt a number back in to SMS

`POST /sms/opt-in`

Removes a phone number from your team's outbound SMS opt-out list, so SMS can be sent to it again. It is the exact reverse of `POST /sms/opt-out`.

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 in a number that was never opted out succeeds and changes nothing.

Note that this removes **every** opt-out entry your team holds for that number, whatever the sender number it was recorded against. A single call re-subscribes the recipient to all of your team's numbers.

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

**Monitoring:** No impact.

## Request body

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

## Response `200`

The number is opted back in. 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)