Quick Start - Unosend

1. Get Onboarded

Book a call or contact us to get set up. We’ll provision your account and provide your Send Mail Token.

2. Add a Domain

Add your sending domain and configure the DNS records we provide (SPF, DKIM, CNAME tracking).

DOMAINS

# Add domain
curl -X POST https://api.unosend.co/v1/domains \
  -H "Authorization: Bearer un_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourdomain.com"}'

# Verify after adding DNS records
curl -X POST https://api.unosend.co/v1/domains/{id}/verify \
  -H "Authorization: Bearer un_your_api_key"

3. Send an Email

curl -X POST https://api.unosend.co/v1/emails \
  -H "Authorization: Bearer un_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": ["user@example.com"],
    "subject": "Hello from Unosend",
    "html": "<h1>Welcome!</h1><p>Your first email.</p>"
  }'

const res = await fetch('https://api.unosend.co/v1/emails', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.UNOSEND_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    from: 'hello@yourdomain.com',
    to: ['user@example.com'],
    subject: 'Hello from Unosend',
    html: '<h1>Welcome!</h1><p>Your first email.</p>'
  })
});
console.log(await res.json());

import requests

res = requests.post(
    'https://api.unosend.co/v1/emails',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'from': 'hello@yourdomain.com',
        'to': ['user@example.com'],
        'subject': 'Hello from Unosend',
        'html': '<h1>Welcome!</h1><p>Your first email.</p>'
    }
)
print(res.json())

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "from": "hello@yourdomain.com",
  "to": ["user@example.com"],
  "status": "queued"
}

Next Steps

Domain Verification

Set up SPF and DKIM

API Reference

See all endpoints