Agregar un dominio

Antes de enviar correos electrónicos a través de MailLand, debe agregar y verificar al menos un dominio de envío. Esto demuestra que usted es propietario del dominio y autoriza a MailLand a enviar en su nombre.

Agregar un dominio

POST https://api.mail.land/v1/domains

Add a domain

curl -X POST https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourdomain.com"
  }'

Respuesta

Estado: 201 Created

Domain response

{
  "id": "k3v9x2m8q1w7z4",
  "domain": "yourdomain.com",
  "verificationStatus": "pending",
  "spfStatus": "pending",
  "dkimStatus": "pending",
  "dmarcStatus": "pending",
  "isFullyVerified": false,
  "trackingSubdomain": "track",
  "useCustomTracking": false,
  "bounceSubdomain": "bounce",
  "useCustomBounce": true,
  "inboundEnabled": false,
  "inboundSubdomain": null,
  "mxVerified": false,
  "healthStatus": "unknown",
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}

Campo	Tipo	Descripción
`id`	string	ID público del dominio
`domain`	string	El nombre de dominio
`verificationStatus`	enum	`pending`, `verified` o `failed`
`spfStatus` / `dkimStatus` / `dmarcStatus`	enum	`pending`, `valid` o `invalid` por registro
`isFullyVerified`	boolean	Propiedad verificada Y SPF, DKIM y DMARC todos `valid`, requerido para enviar
`trackingSubdomain` / `bounceSubdomain`	string	Subdominios de seguimiento/rebote, esté o no activado el dominio personalizado
`useCustomTracking` / `useCustomBounce`	boolean	Si el dominio de seguimiento/rebote personalizado está activado
`inboundEnabled`	boolean	Si la recepción de correo entrante está activada para este dominio
`inboundSubdomain`	string \| null	Subdominio del registro MX entrante; `null` significa la raíz del dominio
`mxVerified`	boolean	Si el registro MX entrante está verificado
`healthStatus`	enum	`unknown`, `healthy`, `warning` o `critical`
`createdAt`	datetime	Cuándo se agregó el dominio

No existe un token de verificación: agregar un dominio crea el registro y genera automáticamente su clave DKIM (sin paso de token).

Después de agregar un dominio, debe configurar los registros DNS y verificar la propiedad antes de poder enviar correos electrónicos. Consulte Configuración DNS para los registros requeridos.

Flujo de configuración

Agregar el dominio

Llame a POST /v1/domains con su nombre de dominio. MailLand crea el registro del dominio y genera su clave DKIM.

Obtener instrucciones DNS

Llame a GET /v1/domains/{id}/dns-instructions para recuperar los registros DNS exactos que debe crear. Consulte Configuración DNS.

Configurar los registros DNS

Agregue los registros SPF, DKIM y DMARC (además de los CNAME opcionales de rebote/seguimiento si están activados) a su proveedor de DNS.

Verificar el dominio

Llame a POST /v1/domains/{id}/verify para activar la verificación. MailLand comprueba todos los registros DNS y actualiza el estado del dominio. Consulte Verificación.

Listar dominios

GET https://api.mail.land/v1/domains

List domains

curl https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

List response

{
  "items": [
    {
      "id": "k3v9x2m8q1w7z4",
      "domain": "yourdomain.com",
      "verificationStatus": "verified",
      "spfStatus": "valid",
      "dkimStatus": "valid",
      "dmarcStatus": "valid",
      "isFullyVerified": true,
      "trackingSubdomain": "track",
      "useCustomTracking": false,
      "bounceSubdomain": "bounce",
      "useCustomBounce": false,
      "inboundEnabled": false,
      "inboundSubdomain": null,
      "mxVerified": false,
      "healthStatus": "healthy",
      "createdAt": "2026-02-17T10:00:00Z",
      "updatedAt": "2026-02-17T10:15:00Z"
    }
  ],
  "nextCursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZGF0OmRlc2MiLCJrIjoi...",
  "hasMore": true
}

Obtener un dominio

GET https://api.mail.land/v1/domains/{id}

Devuelve los detalles completos del dominio, incluido el estado de verificación y todos los subdominios.

Get a domain

curl https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Actualizar la configuración del dominio

Personalice los subdominios de seguimiento y rebote, y active/desactive el entrante. Otros campos de configuración: useCustomTracking, useCustomBounce, inboundEnabled, inboundSubdomain. Estas etiquetas solo surten efecto una vez que el indicador personalizado correspondiente está activo y el registro está verificado. Activar useCustomBounce borra la verificación del registro de rebote, por lo que debe verificar su CNAME nuevamente:

PATCH https://api.mail.land/v1/domains/{id}/settings

Update domain settings

curl -X PATCH https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/settings \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "trackingSubdomain": "links",
    "bounceSubdomain": "returns"
  }'

Cambiar los subdominios requiere actualizar sus registros DNS y volver a verificar el dominio.

Eliminar un dominio

DELETE https://api.mail.land/v1/domains/{id}

Devuelve 204 No Content en caso de éxito. Eliminar un dominio:

Revoca todas las claves DKIM asociadas al dominio
Detiene todos los envíos de correo electrónico desde este dominio
Elimina el enrutamiento de seguimiento y rebote

Delete a domain

curl -X DELETE https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

La eliminación es permanente. Cualquier credencial de API limitada a este dominio ya no podrá enviar correos electrónicos. Las campañas o automatizaciones activas que utilicen este dominio fallarán.

Respuestas de error

Estado	Código	Descripción
`400`	`VALIDATION_FAILED`	Formato de nombre de dominio inválido
`400`	`INVALID_REQUEST`	El dominio ya fue agregado (a este espacio de trabajo o a otro)
`400`	`DOMAIN_SUBDOMAIN_EMPTY`	PATCH de configuración: se envió un campo de subdominio vacío
`400`	`DOMAIN_SUBDOMAIN_CONFLICT`	PATCH de configuración: el subdominio solicitado ya está en uso por otro registro de este dominio
`404`	`DOMAIN_NOT_FOUND`	El ID del dominio no existe
`403`	`PLAN_LIMIT_REACHED`	Se alcanzó el número máximo de dominios para su plan

MailLand limita el número de dominios de envío según el plan, y el límite varía por plan (algunos planes son ilimitados). Al alcanzarlo, añadir un dominio devuelve 403 PLAN_LIMIT_REACHED. Consulte su plan actual en Facturación.

Próximos pasos

Configuración DNS: configurar los registros SPF, DKIM y DMARC
Verificación: verificar la propiedad del dominio
Rotación de claves DKIM: gestionar las claves de firma DKIM

Agregar un dominio