Límites

#Solicitudes por segundo

Cada equipo tiene un límite de solicitudes por segundo, sumando todas las claves. El valor depende del plan:

Valores actualizados desde GET /plans al abrir la página.

El límite vigente para tu equipo aparece en GET /usage (rate_limit). Las apps que tienen una sola clave de envío también ven el límite: GET /usage acepta claves sending_access, y los encabezados X-RateLimit-* llegan en todas las respuestas, incluida la del envío. Toda respuesta incluye los encabezados:

Si superas el límite, la respuesta es 429 rate_limit_exceeded. Para enviar muchos correos, usa el envío por lotes: 100 correos cuentan como una solicitud.

El límite es del equipo, no de la clave, y también vale para el servidor MCP. Los SDKs leen los encabezados por ti: postal.rateLimit (Node.js) y $postal->rateLimit() (PHP) guardan el límite de la última respuesta, incluso con una clave solo de envío, y esperan el Retry-After antes de repetir un 429.

#Cuotas de envío

Los envíos cuentan cuando se crea el correo (incluidos los programados y las pruebas de plantilla). Cada destinatario de una campaña, cada prueba de campaña y cada correo de automatización también cuenta. El día y el mes se cuentan en UTC.

Valores actualizados desde GET /plans al abrir la página.

Al alcanzar la cuota, los envíos reciben 429 daily_quota_exceeded o 429 monthly_quota_exceeded (en SMTP, 452 4.5.3). Una campaña que choca con la cuota a mitad del envío queda pausada y continúa sola cuando la cuota se renueva; un envío de automatización falla, y la ejecución también. En los planes que lo permiten, puedes activar el envío por encima de la cuota en el panel, en Facturación: los correos extra se cobran por millar, sin bloqueo. El plan sigue siendo el mismo; solo pagas por los paquetes adicionales, en la próxima factura. Sigue el consumo en GET /usage.

Reputación de la cuenta. El límite diario vigente es el menor entre el del plan y el tope de la reputación de la cuenta: una puntuación de 0 a 100 que empieza en 0 en las cuentas nuevas y sube con cada día de envíos sin rebotes ni quejas. En los niveles 1 a 4, el tope es de 500, 2.000, 5.000 y 10.000 correos por día; en el nivel 5, solo vale el límite del plan. El límite vigente está en emails.daily.limit de GET /usage, con plan_limit (el del plan) y limited_by (plan o reputation), y el bloque reputation trae la puntuación, el nivel y el siguiente nivel. Cuando es la reputación la que limita, el mensaje del 429 daily_quota_exceeded indica el nivel y el tope.

Adicional de envíos. Cuando el plan del equipo tiene un límite mensual y ofrece el Adicional de envíos, el propietario o un administrador compra, con un pago único, una reserva de envíos que solo se usa después de agotada la cuota mensual: primero la cuota del plan, después la reserva (un crédito por correo, los que vencen antes primero), después el envío por encima de la cuota, si el equipo lo activó, y solo entonces el rechazo. Las campañas no usan la reserva, los correos a direcciones de prueba no gastan crédito, y el límite diario del plan se sigue aplicando. El mensaje del 429 monthly_quota_exceeded dice dónde comprar cuando se puede. Consulta Adicional de envíos y la referencia de la API.

#Recursos por plan

Planes y precios: postal.so/precos o, por API, GET /plans (público, sin clave).

Valores actualizados desde GET /plans al abrir la página.

Los equipos pueden tener límites ajustados individualmente. El valor que cuenta para ti es siempre el de GET /usage.

#Límites y recursos del plan

Cada plan define, por equipo, cuántas cosas puedes tener y qué recursos están incluidos. Superar el límite de un elemento o usar un recurso que el plan no incluye responde 403 plan_limit_reached, con un mensaje que indica cuál. La lista completa, con el texto de cada recurso y si la API ya lo aplica (enforced), está en GET /plans (feature_catalog), y los valores de tu equipo en GET /usage. En los números, null es ilimitado y 0 es no incluido; en los recursos de activado/desactivado, 1 es incluido y 0 no.

Cantidad

Solo bloquean la creación de un elemento más. Lo que ya existe nunca se borra.

Contactos por encima del límite. El límite de contactos del plan de marketing también se puede superar, como el de correos: en Facturación, el propietario o administrador del equipo activa Seguir añadiendo contactos por encima del límite del plan (un botón para cada producto, desactivado de forma predeterminada). Con la opción activada, las importaciones, los formularios, la API y las integraciones de CRM dejan de rechazar con 403 plan_limit_reached al llegar al límite, y los contactos extra se cobran por paquete de 1.000 (redondeando hacia arriba) en la próxima factura, sin cambiar de plan. Lo que se cobra es el mayor número de contactos que el equipo tuvo en el período de facturación (o de contactos que recibieron campañas en el ciclo, si es mayor: consulta más abajo), y borrar contactos después no reduce lo que ya se midió. Los contactos dados de baja y las direcciones suprimidas cuentan como contacto, como siempre. Solo vale con una suscripción de marketing activa, en un plan que permita excedente y que tenga precio de contactos extra; si no, el límite sigue rechazando. El mensaje de rechazo indica cómo activarlo cuando la opción está disponible.

Adicional de contactos. Cuando el plan de marketing del equipo ofrece el Adicional de contactos, el propietario o un administrador suma contactos al límite sin cambiar de plan: el precio del paquete entra en la factura de la suscripción y el límite pasa a ser el del plan más el de los paquetes. El límite que comprueba la API (403 plan_limit_reached) y el que muestra GET /usage ya incluyen los paquetes. Solo valen con un plan de marketing de pago y activo. Mira Adicional de contactos y la referencia de la API.

Contactos que reciben campañas en el ciclo

El límite de contactos del plan de marketing (con el Adicional de contactos) también vale para quien recibe campañas: en el ciclo de uso del equipo (el mes que se renueva el día de tu plan), las campañas y los correos de automatización pueden ir a hasta ese número de contactos diferentes. Cada dirección cuenta una vez por ciclo. Quien ya recibió una campaña en el ciclo sigue contando hasta la renovación, aunque se elimine, y eliminar y volver a crear la misma dirección no cuenta dos veces. Eliminar contactos que aún no recibieron una campaña libera espacio al instante. Enviar varias campañas a los mismos contactos no consume más. Los correos transaccionales no cuentan.

Ejemplo, con un límite de 50.000 contactos: enviar 5 campañas a los mismos 50.000 contactos en el ciclo está dentro del plan. Eliminar los 50.000 que ya recibieron una e importar otros 50.000 en el mismo ciclo pasa del límite: la campaña a los nuevos se rechaza hasta la renovación.

Una campaña que pasaría del límite se rechaza entera, sin enviar nada, con 422 cycle_recipients_limit, un mensaje con los números, la fecha de renovación y qué hacer, y el bloque cycle_recipients (new, used, limit, remaining y resets_at). Postal comprueba de nuevo cuando una campaña programada va a salir: si ya no cabe, queda en pausa con el mismo motivo. Un correo de automatización a un contacto que aún no recibió nada en el ciclo, con el límite lleno, se omite. El propietario y los administradores reciben un correo al llegar al 80% y al 100%. Con el excedente de contactos activado, no se rechaza nada y los contactos por encima del límite se cobran como contactos extra. Sin límite de contactos, no hay límite de destinatarios. El contador está en GET /usage (marketing_recipients) y en Configuración › Uso, y el efecto de una campaña, antes de enviarla, en GET /broadcasts/audience.

Otros límites mensuales no dan 403: emails_per_day y emails_per_month dan 429 (consulta las cuotas de envío); ai_credits, 429 ai_credits_exhausted; email_verifications_per_month, 403 si el plan no incluye la verificación de correos y 429 verification_credits_exhausted cuando se agotan los créditos; y automation_runs: por encima del límite, las nuevas ejecuciones de automatización no empiezan (quedan como skipped).

Recursos de activado/desactivado

retention_days, priority_support, uptime_sla y dedicated_manager son informativos: la API no bloquea nada por ellos (la retención es de 30 días para todos, y el soporte se acuerda aparte).

Cuando el plan baja

Cuando el plan cambia, la cantidad que el equipo ya tiene puede superar el nuevo límite. No se borra nada: de dominios, buzones de entrada, plantillas, layouts, claves de API, webhooks, automatizaciones, segmentos, temas y formularios, los más antiguos hasta el límite siguen activos y los más nuevos quedan con paused_by_plan: true. Un elemento pausado aparece en las listas y se puede leer y eliminar, pero no modificar ni usar: el dominio no envía, la clave de API no autentica, el webhook no recibe eventos, la plantilla no envía, el formulario deja de estar publicado, la automatización no se dispara, el segmento no sirve de público y el buzón de entrada no ejecuta el agente (sigue recibiendo correos). Cualquier intento de modificarlo responde 403 paused_by_plan. Los elementos vuelven solos cuando el plan, el tramo de volumen o el recuento lo permiten, y GET /usage lista lo que está pausado en paused. Los contactos, las personas del equipo y las conexiones no se pausan: el límite solo impide añadir más.

Las cuotas de correos por mes y el número de contactos siguen el tramo de volumen contratado (consulta Planes), y un equipo puede tener límites ajustados individualmente. El valor que cuenta para ti es siempre el de GET /usage.

La escala de volumen se compone de tramos definidos por Postal (por ejemplo 3.000, 50.000, 100.000 y 250.000 correos por mes): cada plan cubre algunos de esos tramos, con el precio de cada uno, y por encima del último tramo solo lo cubre el plan a medida. La lista de los tramos y de los que cubre cada plan está en GET /plans (volume_bands y bands).

#Tamaños y cantidades