Quickstart

Send invoices, receipts and sign-in codes from your own domain. This takes about ten minutes, most of it waiting for DNS.

1. Add and verify your domain

   Sign in to Torvath as an admin and open Admin → Domains. Add the domain you will send from and copy the records it shows into your DNS provider. Once they are live, the domain shows as verified.

   Mail can come from any address on a verified domain, such as billing@ or no-reply@. You don't need a mailbox for it.

2. Make an API key

   Open Admin → API and make a key. Copy it straight away: it is shown once. Keep it on your server, never in a browser or a phone app.

   Tick Test key for a key that checks everything but sends nothing. See Testing.

   Your server's environment

   TORVATH_API_KEY=tv_...

   The email API has to be turned on for your organisation first. If a request is refused with api_off, contact Torvath support.

3. Send your first email

   One request sends one email. The answer has the email's id and how many recipients it went to.

   curlNode.js

   curl https://api.torvathmail.com/v1/emails \
     -H "Authorization: Bearer $TORVATH_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "from": "billing@yourcompany.in",
       "to": "customer@example.com",
       "subject": "Invoice 1042",
       "html": "<p>Your invoice is ready.</p>"
     }'

   201 Created

   { "id": "em_7Kq2xY9pLm3nB8vR", "recipients": 1 }

4. See what happened

   Check an email any time with Get an email. To hear about bounces and spam reports as they happen, turn on events and choose how to take them: pushed to your webhook, or fetched from the events queue.