Configuración de cuenta

Crear una cuentaCopiar enlace de la sección

curl -X POST https://api.mail.land/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your-secure-password",
    "fullName": "Jane Doe",
    "companyName": "Acme Inc"
  }'

{
  "requiresEmailVerification": true,
  "verificationTicket": "vt_abc123...",
  "maskedEmail": "y***@company.com"
}

curl -X POST https://api.mail.land/v1/auth/verify-email-ticket \
  -H "Content-Type: application/json" \
  -d '{
    "ticket": "vt_abc123...",
    "code": "482916"
  }'

curl -X POST https://api.mail.land/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your-secure-password"
  }'

{
  "userId": "abc123def456",
  "email": "[email protected]",
  "fullName": "Jane Doe",
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "rt_abc123...",
  "expiresAt": "2026-02-17T11:30:00Z",
  "tenantCount": 1,
  "activeTenantId": "k3m9x2p7qw4rtz",
  "activeTenantName": "Acme Inc"
}

Espacios de trabajo (Tenants)Copiar enlace de la sección

Cada cuenta de MailLand tiene al menos un espacio de trabajo (también llamado tenant). Los espacios de trabajo aíslan sus dominios, credenciales, plantillas y datos de envío.

Cuándo usar múltiples espacios de trabajoCopiar enlace de la sección

• Entornos separados: producción vs staging
• Productos separados: si gestiona múltiples aplicaciones que envían correo electrónico
• Clientes separados: si es una agencia que gestiona el correo electrónico de múltiples clientes

Cambiar de espacio de trabajoCopiar enlace de la sección

Utilice su token de acceso para cambiar entre espacios de trabajo. tenantId es el id público de tipo cadena del espacio de trabajo, obtenga los ids desde GET /v1/account/tenants:

curl -X POST https://api.mail.land/v1/account/tenants/switch \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "k3m9x2p7qw4rtz"
  }'

Esta operación devuelve un nuevo token de acceso limitado al espacio de trabajo seleccionado.

Autenticación de dos factoresCopiar enlace de la sección

MailLand admite la autenticación de dos factores basada en TOTP (compatible con Google Authenticator, Authy, 1Password, etc.).

Habilitar el 2FACopiar enlace de la sección

1. Llame a POST /v1/auth/2fa/setup para obtener un secreto TOTP y un URI de código QR
2. Escanee el código QR con su aplicación de autenticación
3. Confirme la configuración enviando un código válido mediante POST /v1/auth/2fa/enable

Una vez habilitado, cada inicio de sesión requerirá un código de 6 dígitos de su aplicación de autenticación.

Autenticación de la APICopiar enlace de la sección

MailLand utiliza dos métodos de autenticación:

Tokens Bearer (Panel y gestión de cuenta)Copiar enlace de la sección

Para operaciones de cuenta (inicio de sesión, gestión de espacios de trabajo, configuración), utilice tokens JWT bearer en el encabezado Authorization:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Los tokens caducan tras la duración especificada en expiresAt. Utilice POST /v1/auth/refresh-token para obtener un nuevo token antes de que caduque.

Claves API (Operaciones de correo electrónico)Copiar enlace de la sección

Para el envío de correos electrónicos, la gestión de dominios y todas las llamadas API operacionales, utilice claves API en el encabezado X-API-Key:

X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

Las claves API están vinculadas a un espacio de trabajo y no caducan a menos que establezca una fecha de vencimiento. Consulte API Keys para obtener detalles sobre la creación y gestión de credenciales.

Próximos pasosCopiar enlace de la sección

• API Keys: cree credenciales para enviar correos electrónicos
• Agregar un dominio: registre su dominio de envío
• Inicio rápido: envíe su primer correo electrónico