You can build and test your integration without sending a single real email.
Test keys
API keys created in test mode start with rb_test_. They accept the same requests as live keys and run the same validation, but nothing reaches a mail server. Each email is recorded in Developers › Emails with a Test badge and a simulated outcome.
Sandbox addresses
Addresses at sandbox.robustemail.dev are never delivered, with any key. The outcome depends on the part before the @ of the first recipient:
| Address | Simulated events |
|---|---|
delivered@sandbox.robustemail.dev | email.sent, email.delivered |
bounced@sandbox.robustemail.dev | email.sent, email.bounced (permanent) |
complained@sandbox.robustemail.dev | email.sent, email.delivered, email.complained |
delayed@sandbox.robustemail.dev | email.sent, email.delivery_delayed |
Any other address at the sandbox domain behaves like delivered@. The local part only needs to start with the keyword, so bounced+signup@sandbox.robustemail.dev also bounces.
Typical test plan
- Send with a test key to
delivered@and check the email and its events with Retrieve email. - Send to
bounced@and make sure your app handles a bounce. - Retry a request with the same Idempotency-Key and confirm you get the same email ID back.
- Switch to a live key and send to yourself.