domains

Add a custom domain

Registers a custom receiving domain. The response's setup object carries the exact TXT challenge and MX records to publish; mail is accepted only after verification. Newly created domains are auto-rechecked every 60 s for their first 7 days.

post/v1/domains

Request

  • Base URL: https://api.mailfixture.com
  • URL: https://api.mailfixture.com/v1/domains
  • Auth: HTTP bearer

Request body

fqdnstring required

Fully-qualified domain like mail.example.com; trimmed, trailing dot stripped, lowercased. Prefer a dedicated subdomain.

Response

Domain registered, verification pending.

created_atstring date-time required
fqdnstring required
idstring uuid required
kind'shared' | 'custom' required
mx_ok_atstring date-time nullable required
verified_atstring date-time nullable required
verify_txt_tokenstring nullable required

TXT challenge value; null for shared domains.

Changes

No recorded changes to this operation across all 1 revision of this API.