HonkIOTest mode
Test keys send nothing and charge nothing, but run the same checks and fire the same webhooks as a live key.
Test mode
Test keys send nothing and charge nothing, but run the same checks and fire the same webhooks as a live key. Send from onboarding@test.honkio.ca without any domain, to these addresses:
| Address | What happens |
|---|---|
| delivered@test.honkio.ca | Delivered. |
| bounced@test.honkio.ca | Hard bounce; the address is added to your test suppressions. |
| complained@test.honkio.ca | Delivered, then a spam complaint; the address is added to your test suppressions and opted out in test mode. |
| delayed@test.honkio.ca | A delivery delay, then delivered. |
| *@test.honkio.ca | Any other address, and any ordinary recipient on a test key, is delivered. |
The magic outcome is read from to only: the first to address that matches one of these local parts decides it. cc and bcc are never inspected, so recipients placed there are always delivered.
Suppression works as it does live, on your test list: a second send to bounced@test.honkio.ca is refused with EMAIL_SUPPRESSED. Add a label, such as bounced+2@test.honkio.ca, for a fresh address. Test suppressions never block a live send. A live key can't send to test.honkio.ca at all; that is refused with EMAIL_TEST_ADDRESS_LIVE_KEY.
Emails and webhook events from a test key carry livemode false, and each key reads only its own mode's emails, sent and received.
Test keys can create 200 emails per account in any 24 hours: one for each email of a single send or an array batch, and one for each recipient of an object batch, scheduled sends included. A request that would go past it is refused whole with 429 TEST_EMAIL_QUOTA_EXCEEDED, before any email is created; the details show the limit and how many were used. Simulated received emails have their own 200 per 24 hours. Live keys have no such quota.