List custom SMTP hostnames

Request

List all white-label SMTP hostnames configured for your account.

A custom hostname (e.g. smtp.yourdomain.com) lets your customers or integrations connect to MailerLogic's SMTP infrastructure using your own branded domain. Add a CNAME DNS record pointing to smtp.mailerlogic.net, then call the verify endpoint. SSL is issued automatically after DNS verification.

Security enforcement: Credentials are validated against the hostname they connect through. Only credentials whose smtp_hostname_id matches the connected hostname (or master credentials) are accepted. Generate a dedicated credential for each custom hostname via POST /api/v1/smtp-credentials with smtp_hostname_id set.

From address enforcement: If a hostname is associated with a sending_domain_id, the From address in all emails must use that sending domain — not the hostname itself. If no sending domain is associated (Any / not restricted), any verified domain in the account may be used in From.

Security

ApiKeyAuth

curl -i -X GET \
  https://api.mailerlogic.net/api/v1/smtp-credentials/hostnames \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Hostnames retrieved

Bodyapplication/json

hostnamesArray of objects(SMTPHostname)

Response

{
  "hostnames": [
    { … }
  ]
}