> ## 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 groups

> Create, list, and update transactional groups.

The `transactional-groups` command lets you manage transactional groups, which are used to organize your [transactional emails](/docs/cli/transactional).

## `create`

Create a transactional group.

```bash theme={"dark"}
loops transactional-groups create --name "Account emails"
```

Add a description with `--description`:

```bash theme={"dark"}
loops transactional-groups create \
  --name "Account emails" \
  --description "Password resets, email verification, and login alerts"
```

### Flags

| Flag            | Short | Description                                                            |
| --------------- | ----- | ---------------------------------------------------------------------- |
| `--name`        | `-n`  | Transactional group name <Badge color="red" size="sm">Required</Badge> |
| `--description` | `-d`  | Transactional group description                                        |

## `get`

Get a transactional group by ID.

```bash theme={"dark"}
loops transactional-groups get cmqz4t8b0002mkabc9wxyz123
```

## `list`

List transactional groups.

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

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

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

### Flags

| Flag         | Description                                                                                                                 |
| ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| `--pick`     | Interactively pick a transactional group 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                                                                                       |

## `update`

Update a transactional group.

```bash theme={"dark"}
loops transactional-groups update cmqz4t8b0002mkabc9wxyz123 \
  --name "Transactional emails"
```

### Flags

| Flag            | Short | Description     |
| --------------- | ----- | --------------- |
| `--name`        | `-n`  | New name        |
| `--description` | `-d`  | New description |


## Related topics

- [API Introduction](/docs/api-reference/intro.md)
- [Update a transactional group](/docs/api-reference/update-transactional-group.md)
- [Get a transactional group](/docs/api-reference/get-transactional-group.md)
- [Create a transactional group](/docs/api-reference/create-transactional-group.md)
- [List transactional groups](/docs/api-reference/list-transactional-groups.md)
