resend-cli

-p, --profile <name>

Select stored profile

--json

Force JSON output (auto in non-TTY)

-q, --quiet

Suppress spinners/status (implies --json)

emails

send, get, list, batch, cancel, update, metrics

emails receiving

list, get, attachments, forward, listen

domains

create, verify, get, claim, update, delete, list

logs

list, get, open

usage

Show account-level usage and quota limits (emails, contacts, segments, broadcasts, AI credits, automation runs, domains, rate limit)

careers

list, apply — browse open positions at Resend and apply

suppressions (beta)

list, add, get, delete, batch — requires account enrollment

inboxes

create, list, get, update, delete, threads (list, search, get, update, delete), threads emails (list, get, reply, forward), labels (list, create, update, delete), drafts (list, create, get, update, delete, send), agent (get, update)

api-keys

create, list, update, delete

automations

create, get, list, update, delete, duplicate, stop, open, runs

events

create, get, list, update, delete, send, open

broadcasts

create, send, get, update, delete, list, cancel, duplicate, open, clicked-links, recipients

contacts

create, update, delete, segments, topics, imports

contact-properties

create, update, delete, list

segments

create, get, list, update, delete, contacts

templates

create, publish, duplicate, delete, list

topics

create, update, delete, list

webhooks

create, update, rotate-signing-secret, listen, delete, list, events (list, get, attempts, replay)

auth

login, logout, switch, rename, remove

whoami / doctor / update / open / commands

Utility commands

1

Forgetting --yes on delete commands

All delete/rm subcommands require --yes in non-interactive mode — otherwise the CLI exits with an error

2

Losing the webhook signing_secret

webhooks create returns it, and webhooks get returns it again. Use webhooks rotate-signing-secret if it leaked

3

Omitting --quiet in CI

Without -q, spinners and status text still go to stderr (not stdout). Use -q for JSON on stdout with no spinner noise on stderr

4

Passing --scheduled-at as a flag to batch

There is no --scheduled-at flag on emails batch — set scheduled_at per-email in the JSON file instead

5

Expecting domains list to include DNS records

List returns summaries only — use domains get <id> for the full records[] array

6

Sending a dashboard-created broadcast via CLI

Only API-created broadcasts can be sent with broadcasts send — dashboard broadcasts must be sent from the dashboard

7

Passing --events to webhooks update expecting additive behavior

--events replaces the entire subscription list — always pass the complete set

8

Expecting logs list to include request/response bodies

List returns summary fields only — use logs get <id> for full request_body and response_body

9

CSV import fails with create_error ("missing required email column")

contacts imports create matches columns case-sensitively by lowercase names (email, first_name, last_name) — use --column-map for headers like Email/First Name

10

URL attachment "succeeds" but the email never arrives

The API fetches --attachment "https://..." URLs after returning the email ID — an unreachable URL fails the email asynchronously. Verify with emails get <id> (last_event: "failed"), and always pass ;filename= and ;type= since neither is derived from the URL (defaults: attachment-0, application/octet-stream)

11

An inbox ID after --to becomes a recipient

A variadic flag such as --to, --cc or --labels takes every value up to the next flag. Put the positional IDs of the inboxes commands first: inboxes drafts create <inbox-id> --to a@example.com