Límites

Todo lo que tiene un límite, en un solo lugar. Publicado en vez de descubierto — un límite con el que te topas por sorpresa es un fallo de la documentación.

De un vistazo

1/seg
Solicitudes a la API, por dirección
Sondear una vez por segundo es el patrón previsto.
5días
Retención de mensajes
Desde la llegada, leído o no. Límite fijo.
5MB
Tamaño máximo de mensaje
Se rechaza en el momento SMTP, así que se informa al remitente.
∞
Direcciones por dominio
No se crea nada por adelantado, así que no se cuenta nada.
200
Mensajes devueltos por llamada
50 por defecto. Esto limita una respuesta, no la bandeja: next recorre el resto, sea cual sea la cantidad.
0
Mensajes salientes
No hay endpoint de envío. Por diseño.

Límite de solicitudes

Una solicitud por segundo, por dirección. El límite es por buzón, no por IP, así que un runner de CI compartido que consulta veinte buzones distintos no compite consigo mismo.

Por encima del límite recibes 429 con una cabecera Retry-After en segundos enteros. No hay cuota diaria, ni cuota mensual, ni crédito de ráfaga que gestionar.

Hay un segundo límite, y se indica aquí en lugar de dejarlo por descubrir: 1200 solicitudes por minuto desde una sola dirección de origen. Es exactamente el ejemplo de veinte buzones por segundo de antes, así que la automatización habitual nunca lo alcanza; existe para que un solo host no pueda recorrer diez mil direcciones por segundo.

HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json

{
  "error":   "rate_limited",
  "message": "one request per second, per address"
}

Espera según Retry-After en lugar de una pausa fija. Si el límite cambia alguna vez, el código que lee el encabezado sigue funcionando.

Tamaño del mensaje

Mensajes de hasta 5 MB, adjuntos incluidos. Ese límite lo aplica el servidor de correo durante la conversación SMTP, lo cual importa: al servidor emisor se le informa en el momento en que lo intenta y recibe un fallo real, en lugar de que el mensaje desaparezca sin más.

Qué cuenta: El mensaje codificado completo: encabezados, cuerpo y cada archivo adjunto tras la codificación MIME. Base64 infla un binario en cerca de un tercio, así que un archivo de 20 MB queda cerca del límite.
Qué ocurre en la línea: Un 552 en el momento SMTP. El mensaje nunca se almacena ni aparece en el buzón.
Archivos adjuntos por mensaje: No tiene un límite propio. Lo que importa es el total.

Retención

Un mensaje se elimina 5 días después de llegar, se haya leído o no, y el conteo empieza en la entrega, no en la primera lectura.

Cada mensaje lleva expires_at, así que un cliente nunca tiene que calcular esa fecha ni llevar la cuenta de la política.

Es un límite fijo, no un ajuste: ningún parámetro, plan o cuenta lo amplía. Si algo debe sobrevivir a esa ventana, obtenlo y guárdalo por tu cuenta.

Direcciones y dominios

Direcciones por dominio: Ilimitado, y no se cuenta. Como un buzón nunca se crea, no hay ninguna lista de ellos que crezca.
Reglas de la parte local: De 1 a 64 caracteres: letras, dígitos, punto, guion, guion bajo y más. Debe empezar y terminar con una letra o un dígito. Cualquier otra cosa se rechaza antes de llegar al servidor de correo, en el navegador y de nuevo en el servidor.
Direccionamiento con signo más: name+tag@domain es un buzón distinto aquí, no un alias de name@domain. Es intencionado: las etiquetas son la forma de separar registros, y unirlas fusionaría buzones que debían permanecer separados.
Mayúsculas y minúsculas: Todo se convierte a minúsculas. Name@ y name@ son la misma bandeja.
Dominios personalizados: Sin límite de cuántos apuntes aquí. Cada uno necesita su propio registro MX.

Uso razonable

No hay una cuota que puedas comprar para superar, ni un plan que eleve estos números. Lo que sí hay: si una sola fuente empeora el servicio para todos los demás, se detiene.

Consultas en bloque: Miles de buzones consultados cada segundo desde una sola fuente se limitarán en el borde antes de llegar a la API.
Avalanchas de correo: Un host emisor que abre un número desmedido de conexiones SMTP queda bloqueado durante diez minutos. Los remitentes normales nunca se acercan a ese límite.
Usarnos como relé: Imposible, no solo prohibido: el servidor de correo solo acepta mensajes dirigidos a dominios alojados aquí, así que no puede reenviar nada a ningún sitio.

Nada de esto está pensado para una automatización cualquiera. Sondear una vez por segundo, todo el día, en miles de buzones — ese es el uso previsto, no su límite.