Add a tracking domain
Adds a custom tracking domain to the account, without attaching it to a mailbox. Create a CNAME record from this subdomain to emelia.link at your DNS host: Emelia checks it about a minute later, then every 15 minutes, and generates the HTTPS certificate. After about 6 failed checks the domain goes DISABLED and you receive an email. The domain must be a subdomain (track.yourcompany.com, not yourcompany.com): it is saved in lowercase, without protocol or path. Adding a domain that is already in your account returns it; if it was DISABLED, its verification starts again.
Authorization
apiKey Your 48 character API key, sent as is (a Bearer prefix is tolerated). Create it at https://v3.emelia.io/settings/api.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/domains/create" \ -H "Authorization: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "domain": "track.yourcompany.com" }'{ "status": "OK", "domain": { "_id": "6650f1a2b839d80011c5d0a1", "domainName": "track.yourcompany.com", "status": "PENDING", "dateAdded": "2026-11-02T14:05:00.000Z", "checkAttempt": 0 }}