Register domain for verification

POST

/v1/domains

curl --request POST \
  --url https://api.mailerdash.com/v1/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "domain": "mycompany.com" }'

• Production
• Local development

Starts domain ownership verification. Returns TXT record to add to DNS.

Authorizations

• BearerAuth

Request Body ^required

Media type application/json

object

domain

required

string

Example

mycompany.com

Responses

201

Domain registered — add TXT record then call /verify

Media type application/json

object

domain

string

token

string

instructions

object

record_type

string

record_name

string

record_value

string

next_step

string

Example

{
  "instructions": {
    "record_type": "TXT",
    "record_name": "_md-verify.mycompany.com",
    "record_value": "md-verify=abc123"
  }
}

400

Invalid domain

401

Unauthorized

409

Domain already registered