Getting Started
Send your first email in 5 minutes
This guide walks you through creating an account, adding a sending domain, and sending your first email via the API.
Step 1 — Create your account
Sign up for free — no credit card required.
Step 2 — Add a sending domain
Go to Domains in your dashboard and add the domain you’ll send from (e.g., mail.yourdomain.com).
Mailtactic will provide DNS records to add to your domain registrar:
- SPF — authorizes Mailtactic to send on your behalf
- DKIM — cryptographically signs your emails
- DMARC — tells receiving servers how to handle failures (recommended)
Once your DNS records propagate (usually under 10 minutes), your domain is verified and ready.
Step 3 — Get your API key
Go to API Keys in your dashboard and create a new key with send permission.
Step 4 — Send your first email
curl -X POST https://api.mailtactic.com/v1/messages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "you@example.com",
"from": "hello@yourdomain.com",
"subject": "My first Mailtactic email",
"html": "<h1>It works!</h1><p>You just sent your first email with Mailtactic.</p>",
"text": "It works! You just sent your first email with Mailtactic."
}'
You should receive the email within seconds. Check your Logs tab in the dashboard to see the delivery event.
Step 5 — Use a typed SDK (optional)
Install the Node.js SDK for auto-complete and type safety:
npm install @mailtactic/node
import { Mailtactic } from '@mailtactic/node';
const client = new Mailtactic({ apiKey: process.env.MAILTACTIC_API_KEY });
await client.messages.send({
to: 'user@example.com',
from: 'hello@yourdomain.com',
subject: 'Welcome!',
html: '<h1>Welcome aboard!</h1>',
});