---
title: "Update a customer's opt-outs"
method: PUT
path: "/v1/customers/{customer_id}/optouts"
tags: ["Opt-outs"]
---

# Update a customer's opt-outs

`PUT /v1/customers/{customer_id}/optouts`

Opt a person out of, or back in to, specific senders and channels. Provide one entry per sender/channel in the `optouts` array.

Set `optout` to `true` to opt the person out of a sender, or `false` to opt them back in. The `channel` field is optional and defaults to `sms`.

This request is processed asynchronously; it may take a moment for changes to reflect in read requests.

## Request body

- object
  - `optouts` object[], required — The senders and channels you want to opt the person out of, or back in to. Provide one entry per sender/channel.
    - `from` string, required — The sender you want to opt the person out of, or back in to. For SMS, this is a sender phone number (E.164), an alphanumeric sender ID, or a messaging-service SID; for WhatsApp, it's the sender phone number.
    - `optout` boolean, required — Set to `true` to opt the person out of the sender, or `false` to opt them back in.
    - `channel` 'sms' | 'whatsapp' — The channel for the opt-out. Defaults to `sms`.

## Response `204`

A successful request produces an empty response.

## Other responses

- `400` — The request is malformed—for example, it references an unknown `channel`.
- `404` — The `customer_id` does not exist.
- `429` — Your request is over the 10-per-second limit. `Retry-After` tells you how many seconds you must wait before you send the next request.

## Changes

- **2026-09-02** `5da2740beeb5` — 1 info
  - added the media type `application/json` for the response with the status `429`

[Change history](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/changes/v1/customers/:customer_id/optouts/put.md)

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/00b93971a49f/schema)