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

# recipients

> Manage the people who receive a client's invoices.

Recipients are the contacts an invoice is emailed to. They belong to a client, so every
command here takes `--client <client-identifier>`. For fields and response details, see the
[API reference](/api-reference/recipients/create).

To list a client's recipients, run [`clients show`](/cli-reference/clients#clients-show).

<Note>
  Sample responses on this page show the JSON envelope (`--json`). Pretty output is the
  default on a terminal and its columns adapt to width. See
  [Output formats](/cli/output-formats).
</Note>

## recipients create

Add a recipient to a client. `--user-email` identifies the acting organization user.

```bash theme={"system"}
neetoinvoice recipients create \
  --client 7c1f5e2a9b \
  --name "Sam Smith" \
  --email sam@example.com \
  --user-email oliver@example.com
```

| Flag           | Type     | Required | Default | Description                           |
| -------------- | -------- | -------- | ------- | ------------------------------------- |
| `--client`     | `string` | Yes      |         | Client identifier                     |
| `--email`      | `string` | Yes      |         | Recipient email                       |
| `--name`       | `string` | Yes      |         | Recipient name                        |
| `--user-email` | `string` | Yes      |         | Email of the acting organization user |

```json theme={"system"}
{
  "data": {
    "notice_code": "thumbs_up",
    "recipient": {
      "id": "128c1dfc-b29f-4fda-9a05-8a90e197b81b",
      "name": "Sam Smith",
      "email": "sam@example.com"
    }
  },
  "breadcrumbs": [
    { "label": "Client", "command": "neetoinvoice clients show <client-id>" }
  ]
}
```

## recipients update

Change a recipient's name or email. Only the flags you pass are changed.

```bash theme={"system"}
neetoinvoice recipients update 128c1dfc-b29f-4fda-9a05-8a90e197b81b \
  --client 7c1f5e2a9b \
  --email accounts@example.com
```

### Required arguments

* `<recipient-id>` - the recipient's record ID. See
  [Getting the recipient ID](/getting-started/getting-recipient-id).

| Flag       | Type     | Required | Default | Description       |
| ---------- | -------- | -------- | ------- | ----------------- |
| `--client` | `string` | Yes      |         | Client identifier |
| `--email`  | `string` | No       |         | Recipient email   |
| `--name`   | `string` | No       |         | Recipient name    |

```json theme={"system"}
{
  "data": {
    "notice_code": "thumbs_up",
    "recipient": {
      "id": "128c1dfc-b29f-4fda-9a05-8a90e197b81b",
      "name": "Sam Smith",
      "email": "accounts@example.com"
    }
  },
  "breadcrumbs": [
    { "label": "Client", "command": "neetoinvoice clients show <client-id>" }
  ]
}
```

## recipients delete

Remove a recipient from a client.

```bash theme={"system"}
neetoinvoice recipients delete 128c1dfc-b29f-4fda-9a05-8a90e197b81b --client 7c1f5e2a9b
```

### Required arguments

* `<recipient-id>` - the recipient's record ID.

| Flag       | Type     | Required | Default | Description       |
| ---------- | -------- | -------- | ------- | ----------------- |
| `--client` | `string` | Yes      |         | Client identifier |

```
Recipient deleted.
```