Create a custom domain
POST/api/domains
x-audience: "management"
x-required-scope: "domains:write"
The authenticated account can create a domain. Domain names normalize to DNS form. Domains reserved for Wildmail service use cannot be added. Configure returned TXT and MX records before verification.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 429
- 503
Success
Invalid request.
Missing, invalid or revoked credentials.
Required scope or account access missing.
Resource not found in this account.
Already claimed or domain_limit_reached. Quota errors include the limit.
Shared client-IP or account request allowance exhausted. Retry after the indicated number of seconds. Browser authentication errors can use a different response format.
Response Headers
Cache-Control
no-store
Retry-After
Seconds to wait before retrying.
Request limiting cannot be enforced. Retry later with backoff.
Response Headers
Cache-Control
no-store