Testing
Build and test your integration without sending real mail or using your allowance.
Test keys
Make a key under Admin → API with Test key ticked. It starts tv_test_. Use it exactly like a live key:
- Every request is checked as usual, so a mistake is refused just as it would be live.
- Nothing is sent and nothing counts against your allowance.
- A domain you are still setting up works.
- The email gets an id, and its
email.sentandemail.deliveredevents come straight away, to your webhook or the events queue.
Node.js
const torvath = new Torvath({ apiKey: process.env.TORVATH_API_KEY }); // tv_test_... in development
await torvath.emails.send({ from: "billing@yourcompany.in", to: "bounce@test.torvathmail.com", subject: "Test", text: "Hello" });Test addresses
Send to these to see how your app handles mail that goes wrong.
| Send to | What happens | Events |
|---|---|---|
bounce@test.torvathmail.com | The address refuses the mail. | email.sent, then email.bounced |
complaint@test.torvathmail.com | The mail is delivered, then reported as spam. | email.sent, email.delivered, then email.complained |
| Any other address | Delivered. | email.sent, email.delivered |
Test webhook events
Under Admin → API → Webhook, Send test event pushes an event to your webhook with "test": true, so you can check your signature code before any real mail goes out. See Webhooks.