hugobowne Resend Email
Send emails using the resend-cli. The CLI authenticates via RESEND_API_KEY environment variable.
Sending Email
resend emails send --json \
--from "Claude <claude@ehop.me>" \
--to user@example.com \
--subject "Hello" \
--text "Email body here"
Always pass --json to get machine-readable output.
Required Flags
| Flag | Description |
|---|---|
--from |
Sender address (default to Claude <claude@ehop.me>) |
--to |
Recipient address(es), repeat flag for multiple |
--subject |
Email subject line |
--text or --html or --html-file |
Body content (exactly one required) |
Optional Flags
| Flag | Description |
|---|---|
--html |
HTML body as string |
--html-file |
Path to an HTML file for the body |
--text |
Plain text body |
--cc |
CC recipient(s), repeat flag for multiple |
--bcc |
BCC recipient(s), repeat flag for multiple |
--reply-to |
Reply-to address |
--attachment |
File path(s) to attach, repeat flag for multiple |
--scheduled-at |
Schedule delivery (ISO 8601, e.g. 2024-12-25T09:00:00Z) |
--headers |
Custom headers as key=value pairs |
--tags |
Email tags as name=value pairs |
Examples
Simple text email:
resend emails send --json \
--from "Claude <claude@ehop.me>" \
--to user@example.com \
--subject "Quick update" \
--text "Just a quick note."
HTML email:
resend emails send --json \
--from "Newsletter <news@ehop.me>" \
--to user@example.com \
--subject "Newsletter" \
--html "<h1>Hello</h1><p>Welcome to our newsletter.</p>"
With attachments:
resend emails send --json \
--from "Claude <claude@ehop.me>" \
--to user@example.com \
--subject "Report attached" \
--text "Please find the report attached." \
--attachment /path/to/report.pdf \
--attachment /path/to/data.csv
Multiple recipients with CC:
resend emails send --json \
--from "Claude <claude@ehop.me>" \
--to alice@example.com \
--to bob@example.com \
--cc manager@example.com \
--subject "Team update" \
--text "Hi team..."
Scheduled email:
resend emails send --json \
--from "Claude <claude@ehop.me>" \
--to user@example.com \
--subject "Reminder" \
--text "Don't forget!" \
--scheduled-at "2024-12-25T09:00:00Z"
HTML from file:
resend emails send --json \
--from "Claude <claude@ehop.me>" \
--to user@example.com \
--subject "Report" \
--html-file ./email.html
Output
Success returns JSON with email ID:
{"id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"}
Errors exit with code 1 and return:
{"error": {"message": "...", "code": "..."}}
Limits
- Sender domain must be verified in Resend dashboard
- Max 50 recipients per email
- Max 40MB total size including attachments