Add a Domain

Add a custom domain or create a free sub-domain to your account.

POSThttps://api.maileroo.com/v1/domains

Add a custom domain or create a free sub-domain. After adding a custom domain, you will need to configure the DNS records returned in the response.

Scope: domains.write

Request Body

typestringrequired

The type of domain to add: custom or free.

domain_namestringoptional

Required when type is custom. The domain name to add (e.g. example.com).

sub_domainstringoptional

Required when type is free. The sub-domain name to create.

Request

POST https://api.maileroo.com/v1/domains
Content-Type: application/json

{
  "type": "custom",
  "domain_name": "example.com"
}

Returns 201 Created with a domain detail object (same shape as Get a Domain).