Verificar un dominio

Para enviar correos desde un dominio (por ejemplo, notificaciones@tuempresa.com) debes demostrar que eres el dueño de ese dominio. La verificación se realiza publicando un record TXT en tu DNS — un proceso estándar que no afecta tu correo ni otros servicios del dominio.

Flujo de verificación

El proceso tiene tres pasos:

Registrar el dominio vía API → recibes un token único.
Publicar ese token como record TXT en tu DNS.
Verificar llamando al endpoint /verify → el sistema hace el lookup DNS y, si lo encuentra, marca el dominio como verificado.

Operaciones

Listar dominios registrados

GET /v1/domains

Devuelve todos los dominios de la cuenta con su estado: verified (boolean), verified_at (timestamp o null), y el token asociado.

Registrar dominio

POST /v1/domains

Body: { "domain": "tuempresa.com" }. Respuesta: 201 con el token y las instrucciones exactas para publicar en DNS. Devuelve 409 si el dominio ya está registrado en la cuenta.

Verificar

POST /v1/domains/{domain}/verify

Hace un lookup DNS del TXT. Si lo encuentra, marca verified: true y registra verified_at. Respuesta: { domain, verified, verified_at }. Devuelve 400 si el record TXT no se encuentra aún.

Eliminar dominio

DELETE /v1/domains/{domain}

Requiere API key de administrador. Respuesta: 204.

Ejemplo paso a paso

# Paso 1: registrar el dominio
curl -X POST https://api.mailerdash.com/v1/domains \
  -H "Authorization: Bearer $MAILERDASH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "tuempresa.com"}'

La respuesta incluye las instrucciones exactas que necesitas:

{
  "domain": "tuempresa.com",
  "token": "md-verify=abc123xyz",
  "instructions": {
    "record_type": "TXT",
    "record_name": "_md-verify.tuempresa.com",
    "record_value": "md-verify=abc123xyz",
    "next_step": "Add this TXT record to your DNS, then call POST /v1/domains/tuempresa.com/verify"
  }
}

Paso 2: en tu panel de DNS (Cloudflare, Route 53, Namecheap, etc.) agrega el siguiente record:

Campo	Valor
Nombre / Host	`_md-verify.tuempresa.com`
Tipo	`TXT`
Valor	`md-verify=abc123xyz`
TTL	Cualquiera (300 segundos recomendado)

Espera unos minutos para que el record se propague, luego:

# Paso 3: verificar
curl -X POST https://api.mailerdash.com/v1/domains/tuempresa.com/verify \
  -H "Authorization: Bearer $MAILERDASH_API_KEY"

Respuesta exitosa:

{
  "domain": "tuempresa.com",
  "verified": true,
  "verified_at": "2026-06-22T14:30:00.000Z"
}

Sin dominio verificado no puedes enviar

Intentar enviar un correo (transaccional o campaña) con un from_email cuyo dominio no esté verificado resulta en 403 Forbidden con código domain_not_authorized. El error se devuelve al momento del request, antes de encolar el mensaje.

Una vez verificado, el dominio queda disponible automáticamente para todas las API keys de tu cuenta — no hay ningún paso adicional de activación.

Siguiente paso

Con el dominio verificado, el siguiente paso es configurar los records de autenticación de correo: SPF, DKIM y DMARC. Estos registros mejoran la deliverability y protegen tu dominio de suplantación.

Consulta la guía de SPF, DKIM y DMARC.