Browse API docs
Sender domain
Email campaigns come from an address all Usetix organizers share until you add a domain of your own. With one, they come from an address like news@your-domain.com, signed for your domain. An account has at most one sender domain. See the customer import guide for the steps in the dashboard.
The endpoints need email marketing to be switched on for the account (403 otherwise). Reading requires a token with Read or Read + Write permission; everything else requires Read + Write. See Authentication.
The sender domain
GET /admin/marketing/sender_domain.json returns the domain, or 404 when the account has none.
{
"domain": "dompalais.example",
"local_part": "news",
"address": "news@dompalais.example",
"status": "pending",
"dns_records": [
{ "type": "CNAME", "name": "abc123._domainkey.dompalais.example", "value": "abc123.dkim.amazonses.com", "purpose": "dkim", "found": false },
{ "type": "CNAME", "name": "def456._domainkey.dompalais.example", "value": "def456.dkim.amazonses.com", "purpose": "dkim", "found": false },
{ "type": "CNAME", "name": "ghi789._domainkey.dompalais.example", "value": "ghi789.dkim.amazonses.com", "purpose": "dkim", "found": false },
{ "type": "TXT", "name": "_dmarc.dompalais.example", "value": "v=DMARC1; p=none;", "purpose": "dmarc", "found": true }
],
"checked_at": "2026-11-18T15:01:00Z",
"verified_at": null,
"created_at": "2026-11-18T15:00:00Z"
}
| Field | Meaning |
|---|---|
status |
pending while Usetix waits for the records, verified once campaigns come from address, failed when the records were not found within 72 hours (remove the domain and add it again). |
dns_records |
The records to create with your DNS provider, exactly as given, and whether each was found. The three dkim records are found together. The dmarc record is only needed when neither the domain nor its parent domain has a DMARC record; keep one you already have. |
address |
Where campaigns come from once the domain is verified. Until then, and whenever a record goes missing, they come from the shared address. Replies always go to your support address. |
Add a domain
POST /admin/marketing/sender_domain.json
{ "domain": "dompalais.example", "local_part": "news" }
local_part is the part before the @ and defaults to news. Returns 201 with the sender domain and its DNS records. A domain that cannot be yours (a mailbox provider’s such as gmail.com, one another account uses) returns 422 with errors, as does adding a second domain. 503 means the mail service did not answer; try again later.
Check now
POST /admin/marketing/sender_domain/check.json looks for the records right away and returns the sender domain. Usetix also looks by itself every few minutes while the domain is pending, and emails the account’s owner when it starts or stops sending.
Change the address
PATCH /admin/marketing/sender_domain.json
{ "local_part": "newsletter" }
The domain itself cannot be changed; remove it and add the other one.
Remove the domain
DELETE /admin/marketing/sender_domain.json returns 204. Campaigns come from the shared address again, and you can delete the DNS records.