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, list, and update draft campaigns.
contact-properties
Create and list contact properties.
contacts
Create, update, find, and delete contacts.
completion
Set up shell autocompletion.
components
View saved email components.
email-messages
Get and update draft email messages.
events
Send events to trigger automations.
lists
View your mailing lists.
themes
View saved email themes.
transactional
Send and manage transactional emails.
uploads
Upload files as email assets.
workflows
List workflows and inspect workflow graphs.
Utility commands
loops api-key
Validate your current API key.
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.