# Add an address to the do-not-contact list

Lists one phone number or email address as do not contact, as the caller, with an optional reason; every later text, email, call and blast copy to it is refused. Body {address, reason}. The answer is the line in its one spelling (a number as E.164, a mailbox lower-cased); an address already listed answers the line that stands. Anything that is not a phone number or an email address is a 400. Use it when a person asks, in any words or on a call, not to be contacted.

Access class: `workspace`.

## Endpoint

`POST /v1/comms/opt-outs`

## Request body

Content type: `application/json`.

```json
{
  "address": "string",
  "reason": "string"
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "address": "string",
    "kind": "string",
    "optedOutAt": "2026-01-01T00:00:00Z",
    "optedOutBy": {
      "accountId": "",
      "name": "string"
    },
    "reason": "string",
    "source": "string"
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
