Add a sending domain

POST

/domains

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

• Production

Returns the DNS records (SPF, DKIM, DMARC) to add, then call verify.

Authorizations

• bearerAuth

Request Body

Media typeapplication/json

object

domain

required

string

>= 3 characters <= 255 characters /^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?)*\.[a-zA-Z]{2,}$/

Example

{
  "domain": "mail.yourdomain.com"
}

Responses

201

Domain added with DNS records to publish

Media typeapplication/json

object

domain

required

string

dns_records

required

Array<object>

object

type

required

string

host

required

string

value

required

string

message

required

string

Example^generated

{
  "domain": "example",
  "dns_records": [
    {
      "type": "example",
      "host": "example",
      "value": "example"
    }
  ],
  "message": "example"
}

400

Validation failed

Media typeapplication/json

object

error

required

string

details

object

key

additional properties

nullable

Example

{
  "error": "Validation failed",
  "details": {}
}

401

Missing or invalid API key

Media typeapplication/json

object

error

required

string

message

string

Example

{
  "error": "Invalid API key"
}

409

Domain already added

Media typeapplication/json

object

error

required

string

message

string

Example

{
  "error": "domain_exists"
}