Concepts
Organization. Your tenant. Domains, API keys, messages, webhooks and team members belong to an organization. You can belong to several.
Roles. owner (everything, billing and deletion), admin (manage team, domains, keys, settings), developer (domains, send-only keys, webhooks, suppressions), viewer (read-only).
Domain. A sending domain verified through DKIM. You can only send from a verified domain (or a subdomain of one).
API key. A secret starting with mo_live_ or mo_test_. Scope is send (only the send endpoints) or full. A key can be restricted to one domain.
Test mode. mo_test_ keys never send real email. Messages move through the full pipeline and get synthetic delivered events. Use recipient test+bounce@example.com to simulate a bounce and test+complaint@example.com to simulate a complaint. Test mode is free and capped at 1,000 messages per day.
Suppression list. Addresses we will not send to: hard bounces, complaints, unsubscribes (marketing only) and manual entries. A platform-wide list covers addresses that bounced or complained across several accounts.
Pause and suspend. We pause sending automatically when bounce or complaint rates exceed limits. An administrator can suspend an account for policy violations.