---
title: "Create an opt-out"
method: POST
path: "/v3/messages/opt-outs"
tags: ["SMS and MMS"]
---

# Create an opt-out

`POST /v3/messages/opt-outs`

Opts a phone number out of receiving messages from a Sender ID, a 10DLC campaign, or all outbound messages.

## Request body

- OptOutCreateRequest
  - `opt_out` OptOut, required
    - `number` string, required — Phone number to opt out.
    - `sender_id` string — Sender ID. If omitted, the phone number is opted out of all messages.

## Response `201`

Returns a success confirmation. The opt-out is created.

- object
  - `success` boolean, required — Indicates whether the request was successful.

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>
- `403` — Request failed. The feature is disabled for your account.
- `404` — Request failed. An object with the specified ID is not found.
- `422` — Validation error

---

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