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
- Go to Settings → Domains and click Add Domain.
- Enter your subdomain (e.g., mail.yourdomain.com).
- 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
- In Settings → Domains, click Verify.
- Send a test with the Email API.
- 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.