Transactional

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:

loops transactional send cmnx1d95z001llilji4vapgqs \
  --email test@example.com

Pass data variables inline with --var or from a JSON file with --json-vars:

loops transactional send cmnx1d95z001llilji4vapgqs \
  --email test@example.com \
  --var name=Alice \
  --var company=Acme

loops transactional send cmnx1d95z001llilji4vapgqs \
  --email test@example.com \
  --json-vars ./vars.json

Add attachments with --attachment:

loops transactional send cmnx1d95z001llilji4vapgqs \
  --email test@example.com \
  --attachment ./attachment.pdf

Flags

Flag	Short	Description
`--email`		Recipient email address Required
`--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.

loops transactional create --name "Password reset"

Assign the email to a transactional group with --transactional-group-id:

loops transactional create \
  --name "Password reset" \
  --transactional-group-id cmqz4t8b0002mkabc9wxyz123

Flags

Flag	Short	Description
`--name`	`-n`	Transactional email name Required
`--transactional-group-id`		Transactional group ID to assign this email to

`get`

Get a transactional email.

loops transactional get 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).

loops transactional draft cmnx1d95z001llilji4vapgqs

`publish`

Publish the current draft of a transactional email.

loops transactional publish cmnx1d95z001llilji4vapgqs

`update`

Update a transactional email’s name or group. To update the email’s content, edit its related email message.

loops transactional update cmnx1d95z001llilji4vapgqs \
  --name "Password reset email"

Move the email to another transactional group with --transactional-group-id:

loops transactional update cmnx1d95z001llilji4vapgqs \
  --transactional-group-id cmqz4t8b0002mkabc9wxyz123

Flags

Flag	Short	Description
`--name`	`-n`	Transactional email name Required
`--transactional-group-id`		Move the email to this transactional group

`list`

List published transactional emails.

loops transactional list

Pass --pick to filter the list interactively with fzf and copy the selected transactional ID to your clipboard. Requires fzf to be installed and on your PATH.

loops transactional list --pick

Flags

Flag	Description
`--pick`	Interactively pick a transactional email and copy its ID to the clipboard. Requires 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:

loops send cmnx1d95z001llilji4vapgqs \
  --email test@example.com \
  --var name=Alice

Learn

API

CLI

Guides

Transactional

`send`

Flags

`create`

Flags

`get`

`draft`

`publish`

`update`

Flags

`list`

Flags

`loops send` shortcut

​send

​Flags

​create

​Flags

​get

​draft

​publish

​update

​Flags

​list

​Flags

​loops send shortcut

`send`

Flags

`create`

Flags

`get`

`draft`

`publish`

`update`

Flags

`list`

Flags

`loops send` shortcut