Sandbox / Testing

Test your email integration without touching real DNS, SES, or billing.

What is sandbox mode?

Sandbox mode lets you test your email integration without sending real emails. When you use a TEST key (ms_test_...) or pass sandbox: true in the body, emails are created as DELIVERED immediately — no DNS setup, no SES, no domain verification required.

Using a TEST API key

Create a TEST key in the dashboard under API Keys → Create Key → Test/Sandbox. All sends via this key are sandboxed automatically.

bash
# Use your TEST key for development
MAILSETU_API_KEY=ms_test_xxxxxxxxxxxxxxxx

Sandbox mode in the Playground

In the Dashboard → Playground, select a TEST key and click Send. The email appears in your logs immediately as DELIVERED — without any real send.

Differences from production

In sandbox mode: • No real email is sent • Domain verification is skipped • Monthly quota is not consumed • Email appears as DELIVERED immediately • SES is not called