Custom Domains
By default, emails are sent from noreply@fwd.sarthak.online. Add and verify your own domain to send from any address on it, improving deliverability and brand trust.
Endpoints
GET/api/domains
POST/api/domains
POST/api/domains/:id/verify
DELETE/api/domains/:id
Add a Domain
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | string | Required | Your domain name (e.g., example.com) |
Add domain
curl -X POST https://fwd.sarthak.online/api/domains \
-H "Cookie: your-session-cookie" \
-H "Content-Type: application/json" \
-d '{ "domain": "yourdomain.com" }'The response includes DNS records you need to configure:
Response (with DNS records)
{
"success": true,
"message": "Domain added. Please add the DNS records below.",
"data": {
"id": "dom_abc123",
"domain": "yourdomain.com",
"status": "pending",
"dkimTokens": ["token1", "token2", "token3"],
"dnsRecords": {
"dkim": [
{
"type": "CNAME",
"name": "token1._domainkey.yourdomain.com",
"value": "token1.dkim.amazonses.com"
},
{
"type": "CNAME",
"name": "token2._domainkey.yourdomain.com",
"value": "token2.dkim.amazonses.com"
},
{
"type": "CNAME",
"name": "token3._domainkey.yourdomain.com",
"value": "token3.dkim.amazonses.com"
}
],
"spf": {
"type": "TXT",
"name": "yourdomain.com",
"value": "v=spf1 include:amazonses.com ~all"
}
}
}
}Configure DNS Records
After adding your domain, configure these records with your DNS provider:
DKIM Records (3× CNAME)
Add three CNAME records for DKIM email authentication. These verify that your emails are actually sent from your domain.
| Type | Name | Value |
|---|---|---|
| CNAME | <token>._domainkey.yourdomain.com | <token>.dkim.amazonses.com |
SPF Record (1× TXT)
| Type | Name | Value |
|---|---|---|
| TXT | yourdomain.com | v=spf1 include:amazonses.com ~all |
Verify Domain
After adding DNS records, wait for propagation (usually 10 minutes to 48 hours), then trigger verification:
Verify domain
curl -X POST https://fwd.sarthak.online/api/domains/dom_abc123/verify \
-H "Cookie: your-session-cookie"DNS propagation
DNS changes typically take 10–60 minutes but can take up to 48 hours. If verification fails, wait and try again. You can check propagation using tools like
dig or online DNS lookup services.Plan Limits
| Plan | Verified Domains |
|---|---|
| Free | 1 |
| Pro | 5 |