Email API

Send invoices, receipts and sign-in codes from your app.

A simple HTTPS API for transactional email from your own verified domain, with events for every message. 4,000 emails a month are included, even on Free.

Get an API keyNode SDK

HTTPS only · No SMTP relay · No marketing campaigns

Everything you need to send from code, and nothing you don't.

HTTPS API

Send, check status and fetch events with plain JSON over HTTPS.

Node SDK

@torvath/mail for Node 18+, Cloudflare Workers, Bun and Deno.

Events and webhooks

Delivered, bounced, complained, opened and clicked, by webhook or a queue you fetch.

Never sends twice

Every send carries an idempotency key, so a retry after a lost connection is safe.

Templates

Saved templates with variables, filled in safely (Business).

Test keys

Check everything without sending anything or using your allowance.

Send

One call sends an email.

Send from any address on one of your verified domains, with attachments, tags and your own metadata.

  • Attachments up to your plan's limit
  • Tags and metadata come back in every event
  • Check each recipient's status any time
curl
curl https://api.torvathmail.com/v1/emails \
  -H "Authorization: Bearer $TORVATH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "billing@kaveritextiles.in",
    "to": "buyer@example.com",
    "subject": "Invoice 1042",
    "html": "<p>Your invoice is attached.</p>"
  }'

Events

Know what happened to every email.

Turn on the events you want. Get them pushed to your webhook, signed the Standard Webhooks way, or fetch them from a queue and acknowledge each one.

  • Events wait up to 7 days, or 30 on Business
  • Open and click tracking on Business, for single-recipient emails
  • Unacknowledged events come back after 60 seconds
email.sentAccepted for delivery
email.deliveredReached the inbox server
email.bouncedAddress refused it
email.complainedMarked as spam

Testing

Test keys that send nothing.

A test key checks every request as usual, gives the email an id and fires its events straight away, without sending or counting against your allowance.

  • Works with a domain you are still setting up
  • bounce@test.torvathmail.com always bounces
  • complaint@test.torvathmail.com is delivered, then reported as spam
Key prefixtv_test_
Sends real emailNo
Counts against allowanceNo
EventsStraight away

The API on each plan

ItemFreeBusiness
Emails included a month4,0004,000 + 1,000 per person
After thatUpgrade to send more₹40 per 1,000, with a spending limit you set
Events kept for7 days30 days
TemplatesNoYes
Open and click trackingNoYes

Questions

No. The API is for transactional email: messages a person expects because of something they did, like an invoice or a sign-in code.

No. Sending is over HTTPS only.

Any address on one of your organisation's verified domains.

Each recipient of each email. An email to three people counts as three.

Send your first email in five minutes.

Get an API key, verify your domain and call one endpoint.

Get an API keySee pricing