---
title: "Remove phone numbers from the optouts list."
method: POST
path: "/sms/optouts:remove"
tags: ["OptOutsRemove"]
---

# Remove phone numbers from the optouts list.

`POST /sms/optouts:remove`

## Query parameters

- `api-version` string, required

## Request body

- OptOutRequest — An opt out request.
  - `from` string, required — The sender's identifier (typically phone number in E.164 format) that is owned by the authenticated account.
  - `recipients` OptOutRecipient[], required
    - `to` string, required — The recipient's phone number (in E.164 format).

## Response `200`

Success

- OptOutResponse — Response for an opt out request. Validate the returned items in the response to see which recipients were successfully added or removed from the opt outs list.
  - `value` OptOutResponseItem[], required
    - `to` string, required — The recipient phone number (in E.164 format).
    - `httpStatusCode` integer, required
    - `isOptedOut` boolean — Optional flag specifying if number was Opted Out from receiving messages
    - `errorMessage` string — Optional error message in case of 4xx/5xx errors.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2026-07-13** `a402be972bb5` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`

[Change history](https://skmtc.dev/azure/apis/communication-sms/changes/sms/optouts:remove/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-sms.md) · [All operations](https://skmtc.dev/azure/apis/communication-sms/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-sms/revisions/a402be972bb5/schema)