SMTP Sandbox

SMTP Sandbox captures all outgoing emails from your application without delivering them to real recipients. Point your app's SMTP config at Mail.td and inspect every email in the Pro Dashboard or via the REST API.

How it works

Your Application                Mail.td                     You
     |                            |                          |
     |-- SMTP AUTH PLAIN -------->|                          |
     |<-------- 235 OK ----------|                          |
     |                            |                          |
     |-- MAIL FROM / RCPT TO --->|                          |
     |-- DATA (email body) ----->|                          |
     |<-------- 250 OK ----------|                          |
     |                            |-- Store in Sandbox ----->|
     |                            |-- WebSocket push ------->|
     |                            |-- Webhook POST --------->|

1. Your app connects to smtp.mail.td:25 and authenticates with AUTH PLAIN using a Pro API token as the password.
2. Your app sends emails to any recipient address — the sandbox accepts all recipients.
3. Emails are captured and stored in your sandbox inbox. They are never forwarded to the actual recipient.
4. You inspect captured emails in the Pro Dashboard, query them via REST API, or receive webhook notifications.

Why use a sandbox?

• No accidental emails — Test registration flows, password resets, and transactional emails without reaching real users.
• CI/CD integration — Assert email content in automated tests via the REST API.
• Zero code changes — Only swap SMTP credentials between dev and production; your application code stays the same.
• Full inspection — View HTML rendering, plain text, headers, attachments, and raw .eml source.

Prerequisites

• A Pro account with an active subscription.
• At least one API token created in the Pro Dashboard.

Quick start

1. Create an API token in Pro Dashboard → API Tokens.
2. Configure your app's SMTP:

Setting	Value
Host	smtp.mail.td
Port	25
Auth	PLAIN
Username	anything (e.g. sandbox)
Password	your API token (tm_pro_...)

3. Send a test email from your app. It will appear in Pro Dashboard → SMTP Sandbox.

TIP

The sandbox account is created automatically on first SMTP connection. No manual setup needed.

What happens to captured emails?

• Emails are stored for 7 days, then automatically deleted.
• Each sandbox has a 100 MB storage quota.
• You can purge all emails or delete individual messages at any time.
• Emails are visible via the Pro Dashboard and the Sandbox API.

Next steps

• SMTP Setup Guide — Code examples for Node.js, Python, Go, PHP, Ruby, and Java.
• Sandbox API Reference — Query, inspect, and delete captured emails programmatically.