> ## Documentation Index
> Fetch the complete documentation index at: https://docs.letterbucket.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscriber status

> Accepted input statuses and the string values returned in responses.

The `status` field is optional in single create, bulk create and update requests.

## Input status values

| Value     | Where it works              | Behavior                                                               |
| --------- | --------------------------- | ---------------------------------------------------------------------- |
| `active`  | `POST`, `POST /bulk`, `PUT` | The subscriber becomes active directly. No confirmation email is sent. |
| `pending` | `POST`, `POST /bulk`, `PUT` | The subscriber receives a confirmation email.                          |

<Note>
  The default value on create is **active**. In bulk requests, every item can define its own
  status independently. In `PUT`, if `status` is omitted, the current status does not change.
</Note>

## Response status values

Subscriber responses return status as a readable string.

| Response value | Meaning                  |
| -------------- | ------------------------ |
| `pending`      | Waiting for confirmation |
| `active`       | Active subscriber        |
| `unsubscribed` | Unsubscribed subscriber  |