Resend

Resend CLI

Official CLI for the Resend email API.

Installation

# Preferred install methods
brew install resend/cli/resend

# Or use the official installer
curl -fsSL https://resend.com/install.sh | bash

Setup

1. Create an API key at https://resend.com/api-keys
2. Authenticate with one of:

``bash resend login # or export RESEND_API_KEY="re_your_key" ``

1. For sending email, verify a domain first:

``bash resend domains create --name example.com resend domains verify ``

1. For inbound email commands, create a domain with receiving enabled:

``bash resend domains create --name example.com --receiving ``

1. Optional: manage multiple accounts with team profiles:

``bash resend login --team work export RESEND_TEAM="work" ``

Commands

Authentication and Status

resend login                   # Store API key locally
resend logout                  # Remove stored API key
resend whoami                  # Show current auth source/team
resend doctor                  # Validate CLI setup, auth, domains, agents
resend open                    # Open the Resend dashboard

Emails

resend emails send --from you@example.com --to user@example.com --subject "Hello" --text "Hi"
resend emails batch --file ./emails.json
resend emails receiving list --limit 25
resend emails receiving get 
resend emails receiving attachments 
resend emails receiving attachment  

Domains

resend domains list
resend domains create --name example.com --receiving
resend domains get 
resend domains verify 
resend domains update  --tls enforced --open-tracking
resend domains delete  --yes

API Keys and Teams

resend api-keys list
resend api-keys create --name "CI Token"
resend api-keys delete  --yes
resend teams list
resend teams switch 
resend teams remove 

Contacts, Segments, Topics, Broadcasts

resend contacts list
resend contacts create --email jane@example.com --first-name Jane
resend contacts get jane@example.com
resend contacts update jane@example.com --unsubscribed
resend contacts delete jane@example.com --yes
resend contact-properties list
resend segments list
resend topics list
resend broadcasts list
resend broadcasts create --from hello@example.com --subject "Launch" --segment-id  --html "Hi"
resend broadcasts send 

Webhooks

resend webhooks list
resend webhooks create --endpoint https://app.example.com/hooks/resend --events all
resend webhooks get 
resend webhooks update  --status disabled
resend webhooks delete  --yes

Usage Examples

User: "Send a status email to the team"

resend emails send \
  --from hello@example.com \
  --to team@example.com \
  --subject "Status update" \
  --text "Everything is green."

User: "Do I have any new inbound emails?"

resend emails receiving list --limit 5

User: "Show me the latest email"

resend emails receiving list --json | jq -r '.data[0].id'
resend emails receiving get 

User: "What attachments are on that email?"

resend emails receiving attachments 

User: "Set up a receiving domain"

resend domains create --name example.com --receiving

User: "What domains do I have set up?"

resend domains list

Notes

• Global flags: --api-key, --team, --json, --quiet, --version, --help
• JSON output is useful for agents and scripts; piping output also switches to machine-readable mode
• Inbound email commands live under resend emails receiving ..., not resend email ...
• Received email IDs, domain IDs, broadcast IDs, webhook IDs, and contact IDs are shown in list output
• Use resend --help and resend --help to inspect the latest subcommands and flags

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: mjrussell
• Source: mjrussell/agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.