LFMail API · v1

Tu buzón, conectado a tus sistemas.

Consulta mensajes y descarga el correo original con una clave exclusiva para cada integración.

Empieza en el webmail

  1. Abre Configuración → Apps e integraciones.
  2. Crea una clave y elige el buzón principal o una subcuenta.
  3. Copia la clave una sola vez y guárdala en el servidor de tu sistema.
curl --fail-with-body \
  -H "Authorization: Bearer $LFMAIL_API_KEY" \
  "https://mail.lfmail.com.br/api/v1/messages?limit=25"
mail:read

Una clave. Un buzón.

Cada clave permite solo lectura del buzón elegido, tiene caducidad y revocación inmediata. Los alias entregan en el buzón principal. Las subcuentas mantienen sus mensajes separados.

Endpoints

  • GET/mailbox
  • GET/messages?limit=25
  • GET/messages/{id}
  • GET/messages/{id}/raw
Descargar especificación OpenAPI

Sincronización predecible

Consulta periódicamente, pagina con limit y position y guarda los IDs procesados. Los cambios pueden desplazar las páginas: elimina duplicados por ID. Límite: 60 solicitudes por minuto por clave y 120 por IP. Ante 429, respeta Retry-After; ante fallos temporales, usa espera progresiva.

Protege tu integración

Envía la clave solo en la cabecera Authorization mediante HTTPS. Nunca la incluyas en URLs, JavaScript público o registros. Trata el HTML y los adjuntos como contenido no confiable. La API no permite enviar, modificar ni borrar mensajes.

Cómo llegan los mensajes

La dirección @lfmail.com.br recibe mediante Cloudflare. El transporte guarda temporalmente los mensajes cifrados, comprueba la firma y analiza virus antes de entregar al buzón. El límite es de 25 MiB por mensaje, incluidos adjuntos y codificación. Esta versión no permite enviar correos ni ofrece notificaciones webhook para terceros.