Domain Setup

Authenticate your emails (SPF, DKIM, DMARC) and route bounces/clicks through your domain. After verification, you can add up to 10 sender emails per domain and use them in Campaigns and the Email API.

Overview

Connect a domain (or subdomain) you control. Cllavio generates DNS for SPF, DKIM, DMARC, plus optional CNAMEs for a tracking domain and a return-path. Once verified, add sender emails and start sending.

1) Choose a sending subdomain

  • Use a dedicated subdomain: mail.yourdomain.com or news.yourdomain.com.
  • Keep corporate mail on the root; marketing/transactional on the subdomain.
  • Plan for tracking (e.g., t.mail.yourdomain.com) and return-path (e.g., rp.mail.yourdomain.com).

2) Add domain in Cllavio

  1. Go to Settings → Domains and click Add Domain.
  2. Enter your subdomain (e.g., mail.yourdomain.com).
  3. Copy the generated DNS records exactly as shown for your account.

3) Create DNS records

Example (yours may differ):

# SPF (TXT) — prefer a single include you control
mail.yourdomain.com.  TXT  "v=spf1 include:spf.cllavio.net ~all"

# DKIM (CNAME) — two selectors recommended
s1._domainkey.mail.yourdomain.com.  CNAME  s1.dkim.cllavio.net.
s2._domainkey.mail.yourdomain.com.  CNAME  s2.dkim.cllavio.net.

# DMARC (TXT) — start with p=none; tighten later
_dmarc.mail.yourdomain.com.  TXT  "v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com; adkim=s; aspf=s"

# Return-Path (CNAME)
rp.mail.yourdomain.com.  CNAME  rp.cllavio.net.

# Tracking (CNAME)
t.mail.yourdomain.com.   CNAME  t.cllavio.net.

If your DNS panel auto-appends the zone, omit trailing dots. Use low TTL (300s) during setup.

4) Verify

  1. In Settings → Domains, click Verify.
  2. Send a test with the Email API.
  3. Check headers: spf=pass, dkim=pass, dmarc=pass.

Sender emails (limit 10 per domain)

  • Add up to 10 sender addresses under the verified domain (e.g., no-reply@mail.yourdomain.com, billing@mail.yourdomain.com).
  • Addresses can be used in both Campaigns and the Email API.
  • Remove or replace senders anytime (must stay ≤ 10).

Use in Campaigns & API

Campaigns

When creating a campaign, pick the verified sender from the “From” dropdown.

Email API

Send using a verified sender address:

curl -X POST "https://api-marketing.cllavio.com/api/v1/emails" \
  -H "X-Api-Access-Token: <ACCESS_TOKEN_BOUND_TO_SENDER>" \
  -H "X-Api-Secret-Token: <SECRET_TOKEN_BOUND_TO_SENDER>" \
  -F 'payload={
    "from":"no-reply@mail.yourdomain.com",
    "to":["alice@example.com"],
    "subject":"Hello",
    "body":"<p>Welcome!</p>"
  };type=application/json'

Tokens must belong to the same sender as the from address.

Troubleshooting

  • Not verified: Wait for DNS propagation (5–30 min). Check hostnames exactly match the generated values.
  • SPF conflicts: Merge into a single v=spf1 record; use includes.
  • DKIM fails: Ensure selectors exist and CNAME targets resolve. Use 2048-bit keys.
  • DMARC policy: Start with p=none, then move to quarantine/reject after a few weeks.