Installation
One-line installer
-s -- <version> <path> after sh in the command above. The default installation path is ~/.local/bin.
Homebrew
Script for Windows PowerShell
Go install
Verify
Authentication
The CLI requires a Loops API key. Get one from Settings > API in Loops. There are two ways to authenticate the CLI.Keyring storage
Store a key locally withloops auth login:
loops auth use <name>— set a stored key as the defaultloops auth list— list stored keys and see which is the defaultloops auth get <name>— print a stored API key--team <name>on any command — use a specific stored key for that command
Environment variable
SetLOOPS_API_KEY to use a key directly — useful for CI or when keyring storage isn’t available.
Precedence
When multiple keys are available, the CLI resolves them in this order:LOOPS_API_KEYenvironment variable--teamflag- The current default (set via
loops auth use)
Global flags
These flags can be used with any command.Commands
auth
Log in, switch teams, and manage stored API keys.
campaigns
Create, target, schedule, and update draft campaigns.
audience-segments
Read and create audience segments.
campaign-groups
Organize campaigns into groups.
contact-properties
Create and list contact properties.
contacts
Create, update, find, and delete contacts.
completion
Set up shell autocompletion.
components
View, create, and update email components.
email-messages
Get, preview, and update draft email messages.
events
Send events to trigger automations.
event-patterns
Read event patterns.
lists
View your mailing lists.
themes
View, create, and update email themes.
transactional
Send and manage transactional emails.
transactional-groups
Organize transactional emails into groups.
uploads
Upload files as email assets.
workflows
List, create, and edit workflows and their nodes.
Utility commands
loops api-key
Validate your current API key.
loops dedicated-sending-ips
List the dedicated sending IP addresses assigned to your team.
loops skill install
Install the Loops CLI skill so AI coding agents can discover and use the CLI. Pass --all to install every Loops skill, --global to install it globally, and -y to skip confirmation prompts.
loops --version
Print the CLI version.
loops agent-context
Print a JSON description of every command, subcommand, and flag in the CLI. Designed for AI coding agents (and other tools) that need to discover what the CLI can do without scraping --help output.