Mailtrap
Email testing sandbox that captures outgoing emails in virtual inboxes instead of delivering them. Inspect captured messages, manage test inboxes, and monitor sending domain configuration.
Entity Hierarchy
Everything is scoped by account_id. Always enumerate accounts first to obtain one.
- Accounts — top-level container. Enumerate accounts to get account_id, which is required for all other operations.
- Projects — organizational groups within an account. Each project contains inboxes.
- Inboxes — virtual mailboxes that capture test emails. Requires account_id. Resolve inbox_id before querying messages.
- Messages — individual captured emails within an inbox. Requires both account_id and inbox_id. Each message has headers, body (HTML/text), attachments, and delivery metadata. Fetch rendered HTML or plain text bodies separately for content inspection.
- Sending Domains — configured domains for Mailtrap's email sending product. Account-scoped.
- Billing Usage — current billing cycle usage metrics. Account-scoped.
- Resources — account resource limits and quotas. Account-scoped.
Workflows
- Inspect test emails: enumerate accounts → enumerate inboxes (with account_id) → fetch messages (with account_id + inbox_id) → open message metadata → fetch HTML/text body for content inspection.
- Project organization: enumerate accounts → enumerate projects to see how inboxes are grouped.
- Domain setup audit: enumerate accounts → enumerate sending domains to review configured sending domains and their verification status.
- Usage monitoring: enumerate accounts → open billing usage for current consumption metrics.
Gotchas
- account_id is required everywhere: list accounts first — it's a prerequisite for every other call.
- inbox_id required for messages: list inboxes before fetching messages. Two-step discovery.
- Two products: Mailtrap has Email Testing (sandbox inboxes) and Email Sending (transactional delivery). This integration covers the Email Testing API. Sending domains relate to the Email Sending product.
- Pagination: messages endpoint supports page and per_page params.
