> ## 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 cmnx1d95z001llilji4vapgqs \
  --email test@example.com
```

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

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

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

Add attachments with `--attachment`:

```bash theme={"dark"}
loops transactional send cmnx1d95z001llilji4vapgqs \
  --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 |

## `create`

Create a transactional email with an empty draft.

```bash theme={"dark"}
loops transactional create --name "Password reset"
```

Assign the email to a [transactional group](/docs/cli/transactional-groups) with `--transactional-group-id`:

```bash theme={"dark"}
loops transactional create \
  --name "Password reset" \
  --transactional-group-id cmqz4t8b0002mkabc9wxyz123
```

### Flags

| Flag | Short | Description |
| - | - | - |
| `--name` | `-n` | Transactional email name <Badge color="red" size="sm">Required</Badge> |
| `--transactional-group-id` | | Transactional group ID to assign this email to |

## `get`

Get a transactional email.

```bash theme={"dark"}
loops transactional get cmnx1d95z001llilji4vapgqs
```

The output includes a `url` field with the transactional email's address in the Loops app. Every command that prints a transactional email includes it.

Pass `--web` to open the transactional email in the Loops web app instead of printing its details.

```bash theme={"dark"}
loops transactional get cmnx1d95z001llilji4vapgqs --web
```

### Flags

| Flag | Short | Description |
| - | - | - |
| `--web` | `-w` | Open in the Loops web app instead of printing details |

## `view`

Open a transactional email in the Loops web app. Equivalent to [`get --web`](#get).

```bash theme={"dark"}
loops transactional view cmnx1d95z001llilji4vapgqs
```

## `draft`

Ensure a draft exists for a transactional email. If a draft already exists it is returned unchanged; otherwise a new empty draft is created (seeded from the most recent published version when present).

```bash theme={"dark"}
loops transactional draft cmnx1d95z001llilji4vapgqs
```

## `publish`

Publish the current draft of a transactional email.

```bash theme={"dark"}
loops transactional publish cmnx1d95z001llilji4vapgqs
```

## `update`

Update a transactional email's name or group.

To update the email's content, edit its related [email message](/docs/cli/email-messages).

```bash theme={"dark"}
loops transactional update cmnx1d95z001llilji4vapgqs \
  --name "Password reset email"
```

Move the email to another [transactional group](/docs/cli/transactional-groups) with `--transactional-group-id`:

```bash theme={"dark"}
loops transactional update cmnx1d95z001llilji4vapgqs \
  --transactional-group-id cmqz4t8b0002mkabc9wxyz123
```

### Flags

| Flag | Short | Description |
| - | - | - |
| `--name` | `-n` | Transactional email name <Badge color="red" size="sm">Required</Badge> |
| `--transactional-group-id` | | Move the email to this transactional group |

## `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 cmnx1d95z001llilji4vapgqs \
  --email test@example.com \
  --var name=Alice
```


## Related topics

- [Transactional email](/docs/transactional.md)
- [Transactional groups](/docs/cli/transactional-groups.md)
- [Update a transactional email](/docs/api-reference/update-transactional-email.md)
- [Get a transactional email](/docs/api-reference/get-transactional-email.md)
- [Publish a transactional email](/docs/api-reference/publish-transactional-email.md)