# Quickstart

Send your first email through the Voozin API in about five minutes. You need a Voozin account ([start a free trial](https://app.voozin.com/sign-up), 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](https://voozin.com/docs/domains) 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:

```bash
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:

```bash
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](https://voozin.com/docs/sdk/node):

```bash
npm install voozin
```

```ts
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:

```json
{ "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](https://voozin.com/docs/webhooks): `email.delivered`, `email.bounced`, `email.opened` and more.

## Next steps

- [Send email](https://voozin.com/docs/sending): attachments, tags, scheduling, batch sending and idempotency.
- [Templates](https://voozin.com/docs/templates): keep email content out of your code.
- [Inbound email](https://voozin.com/docs/inbound): receive mail at `support@yourdomain.com` in your app.
- [WordPress plugin](https://voozin.com/docs/wordpress): send all WordPress mail through Voozin without code.
