Add a sending domain

POST 
/domains

Register a new sending domain on the account. Returns the full set of DNS records that must be published before email can send from this domain.

Idempotent: calling this with a domain already registered on the current project returns the existing domain (200) instead of erroring, so re-runs from IaC tooling are safe.

Request

Responses

200

Domain already existed on this project — existing record returned (idempotent replay)

201

Domain added successfully

400

Invalid domain format

403

Plan domain limit reached

409

Domain is registered by another project/account