Add custom SMTP hostname

Request

Register a new white-label SMTP hostname.

After registering, add a DNS CNAME record:

smtp.yourdomain.com  CNAME  smtp.mailerlogic.net

Then call POST /hostnames/{id}/verify to confirm DNS and trigger automatic SSL certificate issuance.

You may optionally associate the hostname with a specific sending domain for organizational purposes.

Security

ApiKeyAuth

Bodyapplication/jsonrequired

hostnamestringrequired

The fully-qualified custom hostname

Example:"smtp.yourdomain.com"

sending_domain_idstring or null, (uuid)

Optional. Associate with a specific verified sending domain.

curl -i -X POST \
  https://api.mailerlogic.net/api/v1/smtp-credentials/hostnames \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "hostname": "smtp.yourdomain.com",
    "sending_domain_id": "4dc1df09-f07f-4cc2-9e75-1240084fe120"
  }'

Responses

Hostname registered. Next step — add the CNAME and call verify.

Bodyapplication/json

hostnameobject(SMTPHostname)

dns_instructionsobject

Response

{
  "hostname": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "hostname": "smtp.yourbrand.com",
    "sending_domain_id": "4dc1df09-f07f-4cc2-9e75-1240084fe120",
    "sending_domain": "yourbrand.com",
    "dns_verified": true,
    "ssl_status": "pending",
    "status": "active",
    "verified_at": "2019-08-24T14:15:22Z",
    "ssl_issued_at": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "dns_instructions": { … }
  },
  "dns_instructions": {
    "type": "CNAME",
    "name": "smtp.yourdomain.com",
    "value": "smtp.mailerlogic.net"
  }
}