Get startedView as Markdown

Quickstart

Send your first email through the Voozin API in about five minutes. You need a Voozin account (start a free trial, no card required) and access to your domain's DNS.

1. Verify a sending domain

In the dashboard open Domains → Add domain and enter the domain you want to send from, for example acme.com. Voozin shows the DNS records to publish (SPF, DKIM, DMARC, MTA-STS and an MX if you also want to receive mail). The setup wizard has step-by-step guides for Cloudflare, GoDaddy, Name.com, Namecheap, Amazon Route 53 and DigitalOcean.

When the records resolve, the domain turns Active. See Domains and DNS for details.

2. Create an API key

Open Developers → API keys → Create key, give it a name and the emails:send scope. The key (ic_live_…) is shown once. Store it as an environment variable:

export VOOZIN_API_KEY="ic_live_..."

Keep keys on the server. Never put them in browser code or a mobile app.

3. Send an email

With curl:

curl https://api.voozin.com/v1/emails \
  -H "Authorization: Bearer $VOOZIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": ["ada@example.com"],
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up!</p>",
    "text": "Thanks for signing up!"
  }'

With the Node.js SDK:

npm install voozin
import { Voozin } from "voozin";
 
const voozin = new Voozin(process.env.VOOZIN_API_KEY);
 
const email = await voozin.emails.send({
  from: "Acme <hello@acme.com>",
  to: ["ada@example.com"],
  subject: "Welcome to Acme",
  html: "<p>Thanks for signing up!</p>",
});
 
console.log(email.id, email.status);

The response looks like this:

{ "id": "6f1c0e7a-…", "status": "QUEUED", "suppressed": [], "scheduled_at": null }

Recipients who previously hard bounced, complained or unsubscribed are listed in suppressed and are not sent to.

4. Track delivery

Look the email up with GET /v1/emails/:id (scope emails:read), or better, receive events as they happen with a webhook: email.delivered, email.bounced, email.opened and more.

Next steps

  • Send email: attachments, tags, scheduling, batch sending and idempotency.
  • Templates: keep email content out of your code.
  • Inbound email: receive mail at support@yourdomain.com in your app.
  • WordPress plugin: send all WordPress mail through Voozin without code.