Getting started

Test mode and sandbox

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:

AddressSimulated events
delivered@sandbox.robustemail.devemail.sent, email.delivered
bounced@sandbox.robustemail.devemail.sent, email.bounced (permanent)
complained@sandbox.robustemail.devemail.sent, email.delivered, email.complained
delayed@sandbox.robustemail.devemail.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

  1. Send with a test key to delivered@ and check the email and its events with Retrieve email.
  2. Send to bounced@ and make sure your app handles a bounce.
  3. Retry a request with the same Idempotency-Key and confirm you get the same email ID back.
  4. Switch to a live key and send to yourself.