Inicio rápido

Requisitos previos

Una cuenta de MailLand (regístrese)
Un dominio de envío verificado
Una API key (credencial)

Las credenciales Sandbox también requieren un dominio de envío registrado y verificado. Nunca entregan a destinatarios normales: un envío Sandbox se acepta y se registra, o se entrega solo a las direcciones de su lista de permitidos de sandbox (Configuración → Sandbox Allow List). Los espacios de trabajo nuevos quedan limitados a esa lista hasta que se verifiquen.

Envíe su primer correo

Obtenga su API key

Después de crear su cuenta y espacio de trabajo, abra Credentials en la barra lateral y cree una nueva credencial:

Producto: Sending
Modo: Production (o Sandbox para pruebas)
Flujo: Transactional
Canal: API

Copie la API key: solo se muestra una vez. La clave tiene este formato:

ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

El prefijo codifica el tipo de credencial:

ml_: todas las claves de MailLand comienzan con esto
p o s: modo Production o Sandbox
e, i o v, producto Sending/Email, Inbound o Validation (las claves de Sending también llevan una letra de stream: et para transaccional, em para marketing, p. ej. ml_pet_...)

Envíe un correo

Realice una solicitud POST al endpoint de envío con los detalles de su correo:

Enviar un correo con curl

curl -X POST https://api.mail.land/v1/transactional/send \
  -H "X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "email": "[email protected]",
      "name": "Your App"
    },
    "to": [
      {
        "email": "[email protected]",
        "name": "Jane Doe"
      }
    ],
    "subject": "Welcome to our platform",
    "htmlContent": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "textContent": "Welcome! Thanks for signing up."
  }'

Verifique la respuesta

Una respuesta exitosa devuelve 202 Accepted con detalles sobre el correo en cola:

Respuesta: 202 Accepted

{
  "success": true,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "messageIds": ["t_a1b2c3d4e5f6..."],
  "acceptedRecipients": ["[email protected]"],
  "rejectedRecipients": [],
  "queuedAt": "2026-02-17T10:30:00Z",
  "isSandboxed": false
}

Campos clave:

jobId: identificador único para rastrear esta operación de envío
messageIds: identificadores individuales de mensaje (con prefijo t_ para transaccional, m_ para marketing)
acceptedRecipients: correos que fueron aceptados para entrega
rejectedRecipients: correos que fueron rechazados (con motivos)
isSandboxed: true si la solicitud usó una credencial sandbox: el correo se registró pero no se envió, o se envió solo a destinatarios de la lista de permitidos

Errores comunes

Estado	Código de error	Significado
`401`	`UNAUTHORIZED`	`X-API-Key` ausente, inválida, vencida o revocada
`422`	`DOMAIN_NOT_VERIFIED`	El dominio del remitente no está verificado
`429`	`RATE_LIMIT_EXCEEDED`	Demasiadas solicitudes: verifique el encabezado `Retry-After`
`429`	`QUOTA_EXCEEDED`	Se alcanzó la cuota de envío mensual
`429`	`SENDING_BLOCKED`	El nivel de verificación de su cuenta aún no permite este envío: complete la verificación (marketing requiere verificación de negocio)
`403`	`SENDING_BLOCKED`	El envío está bloqueado por completo para esta cuenta. Reintentar no ayuda; contacte con soporte

Todos los errores devuelven un cuerpo JSON con los campos code y message:

Respuesta de error

{
  "code": "DOMAIN_NOT_VERIFIED",
  "message": "Domain is not verified",
  "timestamp": "2026-02-17T10:30:00Z",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

Próximos pasos

Referencia de REST API: documentación completa de la API con todos los campos y opciones
SMTP Relay: envíe correos a través de SMTP en lugar de REST
Configuración de dominio: agregue y verifique su dominio de envío
API Keys: configure credenciales con límites de tasa y restricciones de IP

Inicio rápido

Requisitos previosCopiar enlace de la sección

Envíe su primer correoCopiar enlace de la sección

Obtenga su API keyCopiar enlace de la sección

Envíe un correoCopiar enlace de la sección

Verifique la respuestaCopiar enlace de la sección

Errores comunesCopiar enlace de la sección

Próximos pasosCopiar enlace de la sección