Pular para o conteúdo
Docs

Solução de problemas

Por que recebo o erro 429 Rate limit exceeded?

Trate as respostas 429 da API do Emailit. Conheça os limites de envio por segundo e diários, os cabeçalhos de limite de requisições e como solicitar limites maiores.

Atualizado em 11 de out. de 2026

Este artigo explica por que POST /v2/emails retorna 429 e como controlar o ritmo dos seus envios para que isso não aconteça. Os mesmos limites se aplicam ao SMTP, em que aparecem como respostas 452.

Sintomas

A API responde com 429 e um destes corpos:

JSON
{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Maximum 2 messages per second allowed.",
  "limit": 2,
  "current": 2,
  "retry_after": 1
}
JSON
{
  "error": "Daily limit exceeded",
  "message": "Daily sending limit of 5000 messages has been reached.",
  "limit": 5000,
  "current": 5000,
  "retry_after": 41200
}

No SMTP, o comando MAIL FROM falha com 452 4.4.5 Messages per second limit exceeded ou 452 4.5.3 Daily message limit exceeded.

Causa

Cada workspace tem dois limites de envio, compartilhados por todas as chaves de API e pelo SMTP:

  • Por segundo. Workspaces novos começam com 2 e-mails por segundo.
  • Por dia. O Pay as you go começa com 100 e-mails por dia, e 5.000 após a primeira compra de créditos. O Pro e o Business começam com 5.000 e crescem automaticamente. O contador é zerado à meia-noite UTC.

A API conta cada destinatário como um e-mail, então uma requisição com três endereços em to, cc e bcc usa três, e a requisição inteira precisa caber no que resta hoje. Picos de workers em paralelo, loops de novas tentativas sem backoff e jobs em lote que começam ao mesmo tempo são as causas mais comuns.

Toda resposta de envio inclui cabeçalhos que mostram a sua situação:

Cabeçalho Significado
ratelimit-limit / ratelimit-remaining Limite por segundo e o que resta no segundo atual
ratelimit-daily-limit / ratelimit-daily-remaining Limite diário e o que resta hoje
ratelimit-daily-reset Segundos até a meia-noite UTC
retry-after Segundos de espera antes de tentar de novo (apenas em 429)

Solução

  1. Espere e tente de novo. Respeite o retry-after (ou o retry_after no corpo) antes de enviar de novo. Uma requisição com 429 não é enviada nem cobrada, então tentar de novo é seguro. Adicione uma Idempotency-Key para se proteger de novas tentativas no nível da rede.

  2. Controle o ritmo do envio. Use uma fila com um limite de concorrência igual ao ratelimit-limit e aplique backoff exponencial depois de um 429, em vez de tentar de novo em um loop apertado.

  3. Distribua os envios grandes. Se você atingir o limite diário, agende o restante com scheduled_at para depois da meia-noite UTC ou use uma campanha para e-mails de marketing.

  4. Confira os seus limites atuais. O card Sending Limits em Dashboard mostra os seus limites por segundo e por dia e o uso de hoje.

  5. Solicite limites maiores. Em um workspace gratuito no Pay as you go, compre créditos para passar de 100 para 5.000 e-mails por dia. Caso contrário, selecione Request increase no card Sending Limits, escolha de quanto a mais você precisa (+5.000, +10.000 ou +15.000 por dia, ou mais) e conte o que você envia e de onde vêm os seus destinatários. Você pode pedir uma vez a cada 7 dias, e a equipe costuma responder em até 24 horas. No Pro e no Business, o limite também sobe automaticamente à medida que você o usa com uma taxa de bounce baixa.

Consulte Limites de requisições para a referência completa e Limites para todas as cotas dos planos.

Ainda com problemas?

Fale com o suporte ou pergunte no Discord. Informe o volume esperado por dia e por segundo e um exemplo de resposta 429.

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.