Limites

Em resumo

• 1/seg

  Requisições de API, por endereço

  Fazer polling uma vez por segundo é o padrão pretendido.

• 5dias

  Retenção de mensagens

  A partir da chegada, lida ou não. Limite rígido.

• 5MB

  Tamanho máximo da mensagem

  Recusado no momento do SMTP, para que o remetente seja avisado.

• ∞

  Endereços por domínio

  Nada é criado antecipadamente, então nada é contado.

• 200

  Mensagens retornadas por chamada

  Padrão de 50. Isso limita uma resposta, não a caixa de entrada: next percorre o restante, seja qual for a quantidade.

• 0

  Mensagens de saída

  Não há endpoint de envio. De propósito.

Limite de taxa

Uma requisição por segundo, por endereço. O limite é por caixa de entrada, não por IP, então um executor de CI compartilhado consultando vinte caixas diferentes não compete consigo mesmo.

Ao passar do limite você recebe 429 com um cabeçalho Retry-After em segundos inteiros. Não há cota diária, nem cota mensal, nem crédito de pico para gerenciar.

Há um segundo limite, e ele é declarado aqui em vez de deixado para você descobrir: 1200 requisições por minuto de um único endereço de origem. Isso é exatamente o exemplo de vinte caixas de entrada por segundo acima, então a automação comum nunca chega lá — ele existe para que um único host não possa varrer dez mil endereços 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"
}

Use um recuo baseado em Retry-After em vez de uma espera fixa. Se o limite mudar algum dia, o código que lê o cabeçalho continua funcionando.

Tamanho da mensagem

Mensagens de até 5 MB, anexos incluídos. Esse limite é aplicado pelo servidor de e-mail durante a conversa SMTP, o que importa: o servidor remetente é avisado no momento em que tenta enviar e recebe uma falha real, em vez de a mensagem simplesmente desaparecer.

O que conta

A mensagem codificada inteira — cabeçalhos, corpo e todos os anexos após a codificação MIME. O Base64 aumenta um binário em cerca de um terço, então um arquivo de 20 MB fica perto do limite.

O que acontece na linha

Um 552 no momento do SMTP. A mensagem nunca é armazenada e nunca aparece na caixa de entrada.

Anexos por mensagem

Não tem limite separado. O que importa é o total.

Retenção

Uma mensagem é excluída 5 dias depois de chegar, tenha sido lida ou não, e o contador começa na entrega, não na primeira leitura.

Toda mensagem traz expires_at, então um cliente nunca precisa calcular essa data nem acompanhar a política.

É um limite rígido, não uma configuração: nenhum parâmetro, plano ou conta o estende. Se algo precisa sobreviver à janela, busque e armazene do seu lado.

Endereços e domínios

Endereços por domínio

Ilimitado, e não contado. Como uma caixa de entrada nunca é criada, não há lista delas para crescer.

Regras da parte local

De um a 64 caracteres: letras, números, ponto, hífen, sublinhado e mais. Precisa começar e terminar com letra ou número. Qualquer outra coisa é rejeitada antes de chegar ao servidor de e-mail, no navegador e novamente no servidor.

Endereçamento com sinal de mais

name+tag@domain é uma caixa de entrada distinta aqui, não um apelido de name@domain. Isso é proposital — tags são como as pessoas separam cadastros, e uni-las juntaria caixas que deveriam ficar separadas.

Maiúsculas/minúsculas

Tudo é convertido para minúsculas. Name@ e name@ são a mesma caixa de entrada.

Domínios personalizados

Sem limite de quantos domínios você aponta para cá. Cada um precisa do seu próprio registro MX.

Uso justo

Não há cota para comprar e ultrapassar, nem plano que aumente esses números. O que existe em vez disso: se uma única origem piora o serviço para todo mundo, ela é bloqueada.

Consulta em massa

Milhares de caixas de entrada consultadas por segundo a partir de uma única origem serão limitadas na borda antes de chegar à API.

Enxurradas de email

Um host de envio que abre um número irrazoável de conexões SMTP fica bloqueado por dez minutos. Remetentes normais nunca chegam perto disso.

Usando-nos como relay

Impossível em vez de proibido: o servidor de email só aceita mensagens endereçadas a domínios hospedados aqui, então ele não consegue encaminhar nada para lugar nenhum.

Nada disso é pensado para automação comum. Consultar uma vez por segundo, o dia todo, em milhares de caixas de entrada — esse é o uso pretendido, não o seu limite.