my-email-api

name	my-email-api
version	1.0.0
description	Send transactional and bulk email from your own domain. Create mailboxes, send/receive messages, generate AI templates, and manage warmup.
triggers	["email","mailbox","send email","transactional email","template","warmup","inbox","outbox","ses","sender reputation"]
checksum	sha256-pending

MyEmailAPI

Account-scoped email infrastructure tied to your registered domains. Mailboxes belong to domains; sending and receiving work without per-org plumbing. Templates are org-scoped.

Capabilities

Email is built around mailboxes. Each mailbox lives on a registered domain (e.g. [e-mail]) and must be activated for sending before transactional sends work — newly-created mailboxes can receive but not send.

Templates are AI-generated HTML emails (org-scoped). Warmup is a separate flow that gradually ramps a mailbox's send rate to build inbox reputation before high-volume sending.

A registered domain via mydomainapi is the prerequisite — mailboxes need a domain to live on.

Commands

Namespace	Subcommands	Purpose
email mailbox	create, list, activate-sending	Create and manage mailboxes
email message	send, status, sent, inbox, outbox, get	Transactional send + read
email warmup	start, stats, pause, resume, stop	IP/domain warmup for sending reputation
email template	generate, list, get, preview, edit, send-test, delete	AI-generated HTML templates

Examples

# 1. Create a mailbox + activate sending
myapi email mailbox create [e-mail] --display-name "Hello"
myapi email mailbox activate-sending --address [e-mail]

# 2. Send a transactional email
myapi email message send \
  --from [e-mail] --to [e-mail] \
  --subject "Hi" --body "Test message"

# 3. Read inbox / outbox
myapi email message inbox  [e-mail]
myapi email message outbox [e-mail]

# 4. Generate + use a template
myapi email template generate welcome-v1 \
  --prompt "A welcome email with our brand colors and a CTA to /onboarding"
myapi email template list
myapi email template preview <id>            # public preview URL — share with stakeholders
myapi email template send-test <id> --to [e-mail]
myapi email template edit <id> --prompt "Make the CTA larger and red"

# 5. Warm up before a big send
myapi email warmup start --address [e-mail]
myapi email warmup stats --address [e-mail]

Notes

• A mailbox is uniquely identified by its address (username@domain).
• Sending is opt-in per mailbox. Newly-created mailboxes can receive but not send until activate-sending runs.
• Templates are org-scoped. Set a default org once: myapi config set-org <id>.

Run myapi email --help or myapi email <namespace> --help for full flag reference.