Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.unosend.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Why Verify Your Domain?

All plans include unlimited domains — add as many sending domains as you need at no extra cost.

Better Deliverability

DKIM signing proves email authenticity

Custom Sender

Send from your own domain address

Brand Trust

Recipients see your domain, not ours

No Spam Warnings

Avoid “via unosend.co” labels

​
Setup Guide

1

Add Your Domain

Add your domain to Unosend through the dashboard or API:
curl -X POST https://api.unosend.co/domains \
  -H "Authorization: Bearer un_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourdomain.com"
  }'

​
Response

response.json
{
  "id": "dom_xxxxxxxxxxxxxxxx",
  "domain": "yourdomain.com",
  "status": "pending",
  "dns_records": [
    {
      "type": "TXT",
      "name": "yourdomain.com",
      "value": "v=spf1 include:transmail.net ~all"
    },
    {
      "type": "CNAME",
      "name": "bounce.yourdomain.com",
      "value": "cluster90.zeptomail.com"
    },
    {
      "type": "TXT",
      "name": "_dmarc.yourdomain.com",
      "value": "v=DMARC1; p=quarantine; rua=mailto:postmaster@unosend.co; pct=100"
    }
  ],
  "created_at": "2024-01-15T10:30:00Z"
}
2

Configure DNS Records

Add the following 3 DNS records to your domain. Go to your DNS provider (Cloudflare, Route53, GoDaddy, etc.) and add these records:

​
1. SPF Record (TXT)

Authorizes Unosend (via ZeptoMail) to send emails on your behalf:
FieldValue
TypeTXT
Name/Host@ (root domain)
Valuev=spf1 include:transmail.net ~all
TTL3600 (or Auto)
If you already have an SPF record, add include:transmail.net to it. For example: v=spf1 include:transmail.net include:_spf.google.com ~all

​
2. CNAME Record (Bounce Handling)

This enables bounce handling through ZeptoMail’s infrastructure:
FieldValue
TypeCNAME
Name/Hostbounce
Valuecluster90.zeptomail.com
TTL3600 (or Auto)
Configures your domain’s DMARC policy for email authentication:
FieldValue
TypeTXT
Name/Host_dmarc
Valuev=DMARC1; p=quarantine; rua=mailto:postmaster@unosend.co; pct=100
TTL3600 (or Auto)
Just 3 records! SPF and CNAME are required, DMARC is recommended. DKIM is handled automatically by ZeptoMail — no manual key setup needed.
Important: The CNAME record uses the bounce subdomain. The SPF record goes on your root domain.
3

Verify Your Domain

After adding DNS records, trigger verification. DNS propagation can take up to 48 hours, but usually completes within a few minutes.
cURL
curl -X POST https://api.unosend.co/domains/dom_xxxxxxxx/verify \
  -H "Authorization: Bearer un_your_api_key"

​
Response

response.json
{
  "id": "dom_xxxxxxxxxxxxxxxx",
  "domain": "yourdomain.com",
  "status": "verified",
  "verified_at": "2024-01-15T10:35:00Z"
}

​
DNS Record Summary

Here’s a quick reference for all required records:
TypeNameValue
TXT@ (root domain)v=spf1 include:transmail.net ~all
CNAMEbouncecluster90.zeptomail.com
TXT_dmarcv=DMARC1; p=quarantine; rua=mailto:postmaster@unosend.co; pct=100

​
Provider-Specific Instructions

  1. Go to your domain in Cloudflare dashboard
  2. Click DNS in the sidebar
  3. Click Add record for each record:
    • For TXT records: Select TXT, enter name and value
    • For CNAME record: Select CNAME, enter bounce as name, cluster90.zeptomail.com as value
  4. Set proxy status to DNS only (gray cloud) for the CNAME record
  1. Open Route 53 console
  2. Select your hosted zone
  3. Click Create record for each entry:
    • TXT records: Simple routing, enter name and value in quotes
    • CNAME record: Simple routing, enter bounce as name, cluster90.zeptomail.com as value
  1. Go to your domain’s DNS Management
  2. Click Add in the Records section
  3. For TXT records:
    • Type: TXT
    • Name: @ or _dmarc
    • Value: the record value
  4. For CNAME record:
    • Type: CNAME
    • Name: bounce
    • Value: cluster90.zeptomail.com
  1. Go to Domain List → Manage → Advanced DNS
  2. Click Add New Record for each entry
  3. For TXT records: Select TXT Record
  4. For CNAME record: Select CNAME Record
  1. Go to DNS settings for your domain
  2. Click Manage custom records
  3. Add each record with the correct type and values

​
Troubleshooting

Verification taking too long?DNS propagation can take up to 48 hours. You can check propagation status at dnschecker.org.
CNAME record not validating?Ensure the CNAME record for bounce.yourdomain.com points to cluster90.zeptomail.com. If using Cloudflare, make sure the proxy is disabled (gray cloud).
Already have an SPF record?Don’t create a second TXT record. Instead, add include:transmail.net to your existing SPF record. For example: v=spf1 include:transmail.net include:_spf.google.com ~all
Cloudflare proxy enabled?If using Cloudflare, make sure the proxy is disabled (gray cloud icon) for the CNAME record. DNS-only mode is required.

​
Verification Complete!

Once verified, you can start sending emails from your domain. Your emails will be:
  • DKIM-signed with your unique key
  • Delivered via Unosend’s dedicated infrastructure for maximum deliverability
  • Bounce-tracked automatically via the MX record

​
Sending Emails

After verification, send emails from any address at your domain: 
curl -X POST https://api.unosend.co/emails \
  -H "Authorization: Bearer un_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": "recipient@example.com",
    "subject": "Hello from my verified domain!",
    "html": "<p>This email is DKIM-signed and delivered via Unosend.</p>"
  }'