Limites
Requisições por segundo, cotas de envio por plano e os tamanhos máximos de cada recurso.
#Requisições por segundo
Cada time tem um limite de requisições por segundo, somando todas as chaves. O valor depende do plano:
| Plano | Requisições por segundo |
|---|---|
| Free | 5 |
| Pro | 10 |
| Scale | 20 |
| Enterprise | 50 |
O limite em vigor para o seu time aparece em GET /usage (rate_limit). Toda resposta traz os cabeçalhos:
| Cabeçalho | Descrição |
|---|---|
X-RateLimit-Limit | Requisições permitidas por segundo. |
X-RateLimit-Remaining | Quantas ainda cabem no segundo atual. |
Retry-After | Só no 429: segundos até poder tentar de novo. |
X-RateLimit-Reset | Só no 429: quando o limite zera (Unix timestamp). |
Passou do limite, a resposta é 429 rate_limit_exceeded. Para enviar muitos e-mails, use o envio em lote: 100 e-mails contam como uma requisição.
#Cotas de envio
Os envios contam quando o e-mail é criado (inclusive agendados e testes de template). Cada destinatário de uma campanha, cada teste de campanha e cada e-mail de automação também conta. O dia e o mês são contados em UTC.
| Plano | Por dia | Por mês |
|---|---|---|
| Free | 100 | 3.000 |
| Pro | Sem limite | 50.000 |
| Scale | Sem limite | 100.000 |
| Enterprise | Sem limite | Sob medida |
Ao atingir a cota, os envios recebem 429 daily_quota_exceeded ou 429 monthly_quota_exceeded (no SMTP, 452 4.5.3). Uma campanha que esbarra na cota no meio do envio fica pausada e continua sozinha quando ela renova; um envio de automação falha, e a execução também. Nos planos que permitem, você pode ativar o envio além da cota no painel, em Cobrança: os e-mails extras são cobrados por mil, sem bloqueio. Acompanhe o consumo em GET /usage.
Reputação de envio
Para proteger a entrega de todos, a Postal pausa os envios de um time quando, nos últimos 7 dias, os bounces permanentes passam de 5% ou as reclamações de spam passam de 0,3% dos e-mails enviados (a partir de 100 envios). Enquanto isso, os envios recebem 403 sending_paused. Fale com [email protected] para revisar e liberar.
#Recursos por plano
| Free | Pro | Scale | Enterprise | |
|---|---|---|---|---|
| Domínios | 3 | 10 | 1.000 | Sem limite |
| Inboxes | 3 | 10 | 100 | Sem limite |
| Inboxes no seu domínio | Não | Sim | Sim | Sim |
| Pessoas no time | 3 | 10 | Sem limite | Sem limite |
| Créditos de IA por mês | 10 | 100 | 1.000 | Sem limite |
| Execuções de automação por mês | 1.000 | 10.000 | 100.000 | Sem limite |
| Contatos (plano de marketing) | 1.000 | 5.000 | 50.000 | Sem limite |
| Segmentos (plano de marketing) | 3 | Sem limite | Sem limite | Sem limite |
| Campanhas por mês (plano de marketing) | Sem limite | Sem limite | Sem limite | Sem limite |
Times podem ter limites ajustados individualmente. O valor que vale para você é sempre o de GET /usage.
#Tamanhos e quantidades
| O quê | Limite |
|---|---|
Destinatários em to | 50 por e-mail |
E-mails por lote (POST /emails/batch) | 100 |
| Anexos | 40 MB no total por e-mail |
| Mensagem pelo SMTP | 40 MB e 50 destinatários |
Agendamento (scheduled_at) | Até 30 dias no futuro |
| Tags | 50 por e-mail; nome e valor com até 256 caracteres |
| Assunto e valores de cabeçalho | 998 caracteres |
| Itens por página nas listas | 100 |
Idempotency-Key | 256 caracteres, guardada por 24 horas |
Imagens (POST /assets) | 5 MB |
| Exportações em andamento | 3 por time |
| Importações de contatos | CSV de até 20 MB; 3 em andamento por time |
| Propriedades de contato | 100 por time |
| Envios a um formulário público | 5 por minuto por IP |
| Agendamento de campanhas | Até 30 dias no futuro |
| Teste de campanha | 5 endereços |
Eventos (POST /events) | Nome com até 100 caracteres; properties com até 16 KB |
| Automações | 100 passos; 10 filtros no gatilho; 20 ações por update_contact; espera de até 365 dias |
| Passo de webhook das automações | 3 tentativas, 15 segundos cada |
| Retenção de e-mails, webhooks e logs | 30 dias |
| Retenção de eventos | 90 dias |