MailerLite CLI
A command-line interface for the MailerLite API. Manage subscribers, campaigns, automations, groups, forms, e-commerce, and more — all from your terminal.
The CLI also includes an interactive TUI dashboard for browsing your MailerLite data in real time.
Installation
Homebrew (macOS)
brew install --cask mailerlite/tap/mailerlite
1
GitHub Releases
Download pre-built binaries for Linux, macOS, and Windows from the releases page.
Go install
go install github.com/mailerlite/mailerlite-cli@latest
1
From source
Requires Go 1.25+.
git clone https://github.com/mailerlite/mailerlite-cli.git
cd mailerlite-cli
go build -o mailerlite .
1
2
3
2
3
Move the binary to somewhere on your $PATH:
sudo mv mailerlite /usr/local/bin/
1
Nix
Run directly without installing:
nix run git+ssh://git@github.com/mailerlite/mailerlite-cli.git
1
Or install into your profile:
nix profile install git+ssh://git@github.com/mailerlite/mailerlite-cli.git
1
Authentication
The CLI supports two authentication methods: OAuth (recommended) and API token.
OAuth (recommended)
mailerlite auth login
1
This opens your browser to authorize the CLI with your MailerLite account. OAuth tokens are automatically refreshed when they expire.
API Token
mailerlite auth login --method token
1
You'll be prompted to enter your MailerLite API token. You can generate one from your MailerLite dashboard.
Environment variable
You can also set the API token via environment variable:
export MAILERLITE_API_TOKEN="your_token_here"
1
Multiple profiles
Manage multiple profiles for different accounts or environments:
# Add profiles
mailerlite profile add staging
mailerlite profile add production
# List profiles
mailerlite profile list
# Switch active profile
mailerlite profile switch staging
# Use a specific profile for one command
mailerlite subscriber list --profile production
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
Multiple accounts
If your OAuth credentials have access to multiple MailerLite accounts:
# List accounts
mailerlite account list
# Switch active account
mailerlite account switch <account_id>
1
2
3
4
5
2
3
4
5
Auth status and logout
# Check auth status
mailerlite auth status
# Log out
mailerlite auth logout
1
2
3
4
5
2
3
4
5
Global flags
Every command supports these flags:
| Flag | Description |
|---|---|
--json | Output raw JSON instead of formatted tables |
--verbose, -v | Print HTTP request and response details |
--profile <name> | Use a specific auth profile |
--yes, -y | Skip confirmation prompts |
--help, -h | Show help for any command |
Commands
Subscribers
# List subscribers
mailerlite subscriber list
mailerlite subscriber list --limit 50 --status active
# Filter by email
mailerlite subscriber list --email user@example.com
# Get subscriber count
mailerlite subscriber count
# Get subscriber details (by ID or email)
mailerlite subscriber get <id_or_email>
# Create or update a subscriber
mailerlite subscriber upsert \
--email "user@example.com" \
--status active \
--groups "group1_id,group2_id" \
--fields '{"name":"John","company":"Acme"}'
# Update a subscriber
mailerlite subscriber update <id> --status unsubscribed
# Delete a subscriber
mailerlite subscriber delete <id>
# Forget a subscriber (GDPR)
mailerlite subscriber forget <id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
Groups
# List groups
mailerlite group list
mailerlite group list --limit 50 --sort name
# Create a group
mailerlite group create --name "Newsletter"
# Update a group
mailerlite group update <group_id> --name "Weekly Newsletter"
# Delete a group
mailerlite group delete <group_id>
# List subscribers in a group
mailerlite group subscribers <group_id>
# Assign / unassign a subscriber
mailerlite group assign <group_id> <subscriber_id>
mailerlite group unassign <group_id> <subscriber_id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Campaigns
# List campaigns
mailerlite campaign list
mailerlite campaign list --status sent --type regular
# Get campaign details
mailerlite campaign get <campaign_id>
# Create a campaign
mailerlite campaign create \
--name "Welcome Campaign" \
--type regular \
--subject "Welcome!" \
--from "sender@yourdomain.com" \
--from-name "Sender Name" \
--content "<h1>Hello</h1>" \
--groups "group_id"
# Update a campaign
mailerlite campaign update <campaign_id> --subject "Updated Subject"
# Schedule a campaign
mailerlite campaign schedule <campaign_id> \
--delivery scheduled \
--date 2026-03-01 \
--hours 10 \
--minutes 0
# Cancel a campaign
mailerlite campaign cancel <campaign_id>
# List campaign subscriber activity
mailerlite campaign subscribers <campaign_id>
# List available campaign languages
mailerlite campaign languages
# Delete a campaign
mailerlite campaign delete <campaign_id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
Automations
# List automations
mailerlite automation list
mailerlite automation list --enabled true
# Get automation details
mailerlite automation get <automation_id>
# List automation subscriber activity
mailerlite automation subscribers <automation_id>
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
Forms
# List forms
mailerlite form list
mailerlite form list --type popup --sort name
# Get form details
mailerlite form get <form_id>
# Update a form
mailerlite form update <form_id> --name "Updated Form"
# Delete a form
mailerlite form delete <form_id>
# List form subscribers
mailerlite form subscribers <form_id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Fields
# List subscriber fields
mailerlite field list
# Create a field
mailerlite field create --name "Company" --type text
# Update a field
mailerlite field update <field_id> --name "Organization"
# Delete a field
mailerlite field delete <field_id>
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
Segments
# List segments
mailerlite segment list
# Update a segment
mailerlite segment update <segment_id> --name "VIP Customers"
# Delete a segment
mailerlite segment delete <segment_id>
# List subscribers in a segment
mailerlite segment subscribers <segment_id>
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
Webhooks
# List webhooks
mailerlite webhook list
# Create a webhook
mailerlite webhook create \
--name "My Webhook" \
--url "https://example.com/webhook" \
--events "subscriber.created,campaign.sent" \
--enabled
# Get webhook details
mailerlite webhook get <webhook_id>
# Update a webhook
mailerlite webhook update <webhook_id> --name "Updated Webhook"
# Delete a webhook
mailerlite webhook delete <webhook_id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Webhook events
| Event | Description |
|---|---|
subscriber.created | A new subscriber was added |
subscriber.updated | A subscriber was updated |
subscriber.unsubscribed | A subscriber unsubscribed |
subscriber.added_to_group | A subscriber was added to a group |
subscriber.removed_from_group | A subscriber was removed from a group |
subscriber.bounced | A subscriber's email bounced |
subscriber.automation_triggered | An automation was triggered for a subscriber |
subscriber.automation_completed | An automation completed for a subscriber |
campaign.sent | A campaign was sent |
campaign.draft_created | A campaign draft was created |
Timezones
# List available timezones
mailerlite timezone list
1
2
2
E-Commerce: Shops
# List shops
mailerlite shop list
# Get shop details
mailerlite shop get <shop_id>
# Create a shop
mailerlite shop create --name "My Store" --url "https://mystore.com"
# Update a shop
mailerlite shop update <shop_id> --name "Updated Store"
# Delete a shop
mailerlite shop delete <shop_id>
# Get shop count
mailerlite shop count
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
E-Commerce: Products
All product commands require --shop.
# List products
mailerlite product list --shop <shop_id>
# Get product details
mailerlite product get <product_id> --shop <shop_id>
# Create a product
mailerlite product create --shop <shop_id> \
--name "T-Shirt" \
--price 29.99 \
--url "https://mystore.com/tshirt" \
--description "A nice t-shirt"
# Update a product
mailerlite product update <product_id> --shop <shop_id> --price 24.99
# Delete a product
mailerlite product delete <product_id> --shop <shop_id>
# Get product count
mailerlite product count --shop <shop_id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
E-Commerce: Categories
All category commands require --shop.
# List categories
mailerlite category list --shop <shop_id>
# Get category details
mailerlite category get <category_id> --shop <shop_id>
# Create a category
mailerlite category create --shop <shop_id> --name "Apparel"
# Update a category
mailerlite category update <category_id> --shop <shop_id> --name "Clothing"
# Delete a category
mailerlite category delete <category_id> --shop <shop_id>
# Get category count
mailerlite category count --shop <shop_id>
# List products in a category
mailerlite category products <category_id> --shop <shop_id>
# Assign / unassign a product
mailerlite category assign-product <category_id> \
--shop <shop_id> --product <product_id>
mailerlite category unassign-product <category_id> \
--shop <shop_id> --product <product_id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
E-Commerce: Customers
All customer commands require --shop.
# List customers
mailerlite customer list --shop <shop_id>
# Get customer details
mailerlite customer get <customer_id> --shop <shop_id>
# Create a customer
mailerlite customer create --shop <shop_id> \
--email "customer@example.com" \
--first-name "John" \
--last-name "Doe"
# Update a customer
mailerlite customer update <customer_id> --shop <shop_id> --first-name "Jane"
# Delete a customer
mailerlite customer delete <customer_id> --shop <shop_id>
# Get customer count
mailerlite customer count --shop <shop_id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
E-Commerce: Orders
All order commands require --shop.
# List orders
mailerlite order list --shop <shop_id>
# Get order details
mailerlite order get <order_id> --shop <shop_id>
# Create an order
mailerlite order create --shop <shop_id> \
--customer <customer_id> \
--status complete \
--total 59.98 \
--currency USD \
--items '[{"product_id":"prod1","quantity":2,"price":29.99}]'
# Update an order
mailerlite order update <order_id> --shop <shop_id> --status complete
# Delete an order
mailerlite order delete <order_id> --shop <shop_id>
# Get order count
mailerlite order count --shop <shop_id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
E-Commerce: Carts
All cart commands require --shop.
# List carts
mailerlite cart list --shop <shop_id>
# Get cart details
mailerlite cart get <cart_id> --shop <shop_id>
# Update a cart
mailerlite cart update <cart_id> --shop <shop_id> --currency EUR
# Get cart count
mailerlite cart count --shop <shop_id>
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
E-Commerce: Cart Items
All cart-item commands require --shop and --cart.
# List cart items
mailerlite cart-item list --shop <shop_id> --cart <cart_id>
# Get cart item details
mailerlite cart-item get <item_id> --shop <shop_id> --cart <cart_id>
# Add an item to a cart
mailerlite cart-item create --shop <shop_id> --cart <cart_id> \
--product <product_id> \
--quantity 2 \
--price 29.99
# Update a cart item
mailerlite cart-item update <item_id> \
--shop <shop_id> --cart <cart_id> --quantity 3
# Delete a cart item
mailerlite cart-item delete <item_id> --shop <shop_id> --cart <cart_id>
# Get cart item count
mailerlite cart-item count --shop <shop_id> --cart <cart_id>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
E-Commerce: Bulk Import
# Import categories from JSON file
mailerlite import categories --shop <shop_id> --file categories.json
# Import products from JSON file
mailerlite import products --shop <shop_id> --file products.json
# Import orders from JSON file
mailerlite import orders --shop <shop_id> --file orders.json
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
Interactive dashboard
Launch the TUI dashboard for a visual overview of your MailerLite account:
mailerlite dashboard
1
The dashboard provides a lazygit-style interface with sidebar navigation between subscribers, campaigns, automations, groups, and forms. Use vim-style keybindings (j/k to navigate, Enter to select). Press ? for help or q to quit.
JSON output
Add --json to any command to get raw JSON output, useful for scripting and piping to tools like jq:
# Pipe to jq
mailerlite subscriber list --json | jq '.[].email'
# Extract an ID
mailerlite group create --name "Test" --json | jq -r '.id'
1
2
3
4
5
2
3
4
5
The CLI also respects the NO_COLOR environment variable to disable colored output.
Shell completion
Generate shell completions for your shell:
# Bash
source <(mailerlite completion bash)
# Zsh
mailerlite completion zsh > "${fpath[1]}/_mailerlite"
# Fish
mailerlite completion fish | source
# PowerShell
mailerlite completion powershell | Out-String | Invoke-Expression
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11