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

# Transactional

> Send and manage transactional emails.

The `transactional` command lets you send and manage transactional emails. There is also a top-level `loops send` shortcut for quickly sending a transactional email.

## `send`

Send a transactional email.

```
loops transactional send <id> [--flags]
```

Example:

```bash theme={"dark"}
loops transactional send clx1234abc \
  --email test@example.com
```

Pass [data variables](/transactional#data-variables) inline with `--var` or from a JSON file with `--json-vars`:

```bash theme={"dark"}
loops transactional send clx1234abc \
  --email test@example.com \
  --var name=Alice \
  --var company=Acme
```

```bash theme={"dark"}
loops transactional send clx1234abc \
  --email test@example.com \
  --json-vars ./vars.json
```

Add attachments with `--attachment`:

```bash theme={"dark"}
loops transactional send clx1234abc \
  --email test@example.com \
  --attachment ./attachment.pdf
```

### Flags

| Flag                | Short | Description                                                           |
| ------------------- | ----- | --------------------------------------------------------------------- |
| `--email`           |       | Recipient email address <Badge color="red" size="sm">Required</Badge> |
| `--var`             | `-v`  | Data variable as `KEY=value` (repeatable)                             |
| `--json-vars`       | `-j`  | Path to a JSON file of data variables                                 |
| `--attachment`      | `-A`  | Path to a file to attach (repeatable)                                 |
| `--add-to-audience` | `-a`  | Create a contact in your audience if one doesn't exist                |
| `--idempotency-key` |       | Idempotency key to prevent duplicate sends                            |

## `list`

List published transactional emails.

```bash theme={"dark"}
loops transactional list
```

Pass `--pick` to filter the list interactively with [fzf](https://github.com/junegunn/fzf) and copy the selected transactional ID to your clipboard. Requires `fzf` to be installed and on your `PATH`.

```bash theme={"dark"}
loops transactional list --pick
```

### Flags

| Flag         | Description                                                                                                                 |
| ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| `--pick`     | Interactively pick a transactional email and copy its ID to the clipboard. Requires [fzf](https://github.com/junegunn/fzf). |
| `--per-page` | Results per page (10–50, default 20)                                                                                        |
| `--cursor`   | Pagination cursor for a specific page                                                                                       |

## `loops send` shortcut

`loops send` is a top-level shortcut for `loops transactional send`. It accepts the same flags.

```
loops send <id> [--flags]
```

Example:

```bash theme={"dark"}
loops send clx1234abc \
  --email test@example.com \
  --var name=Alice
```