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.
# Use your TEST key for development
MAILSETU_API_KEY=ms_test_xxxxxxxxxxxxxxxxSandbox 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
