Endpoints da API v2 /emails Já Disponíveis

Temos o prazer de anunciar que os endpoints de e-mail já estão disponíveis na API v2! Agora você pode enviar, consultar, atualizar e-mails agendados e cancelar e-mails pendentes — tudo através da nossa poderosa API REST.

Novos Endpoints

Enviar E-mail

POST /v2/emails

Envie um único e-mail para um ou múltiplos destinatários. O endpoint de envio oferece suporte a:

• Múltiplos destinatários — Envie para até 50 destinatários (TO, CC, BCC combinados)
• Templates — Use aliases ou IDs de templates com substituição de variáveis usando a sintaxe {{variavel}}
• Anexos — Inclua arquivos via conteúdo base64 ou URL
• Agendamento — Agende e-mails para entrega futura usando ISO 8601, timestamps Unix ou linguagem natural como "amanhã às 9h"
• Rastreamento — Substitua as configurações padrão de rastreamento do domínio para aberturas e cliques
• Metadados — Anexe pares chave-valor personalizados que são armazenados e retornados com o e-mail
• Idempotência — Evite envios duplicados com o cabeçalho Idempotency-Key

Cada destinatário recebe seu próprio ID de e-mail único para rastreamento individual ao enviar para múltiplos endereços.

Consultar E-mail

GET /v2/emails/{id}

Recupere informações detalhadas sobre um e-mail específico, incluindo:

• Status atual (pendente, agendado, enviado, entregue, rejeitado, cancelado)
• Cabeçalhos e conteúdo bruto do e-mail
• Configurações de rastreamento
• Metadados personalizados
• Timestamps de criação e atualizações

Atualizar E-mail Agendado

POST /v2/emails/{id}

Reagende um e-mail que está programado para entrega futura. Você pode alterar o horário agendado desde que o e-mail esteja pelo menos 3 minutos antes de ser enviado.

Cancelar E-mail

POST /v2/emails/{id}/cancel

Cancele um e-mail agendado ou pendente antes que seja enviado. Para e-mails agendados, o cancelamento deve ser solicitado pelo menos 3 minutos antes do horário programado para envio.

Limites de Taxa

Toda resposta inclui cabeçalhos de limite de taxa para que você possa monitorar seu uso:

• ratelimit-limit — Máximo de requisições por segundo
• ratelimit-remaining — Requisições restantes no segundo atual
• ratelimit-daily-limit — Máximo de requisições diárias
• ratelimit-daily-remaining — Requisições diárias restantes

Documentação

A documentação completa com exemplos de código em Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET e cURL está disponível:

• Enviar E-mail
• Consultar E-mail
• Atualizar E-mail Agendado
• Cancelar E-mail

Em Breve: API de Templates

Estamos trabalhando na API de Templates que permitirá criar, atualizar e gerenciar templates de e-mail programaticamente. Fique atento a esta adição empolgante!

Aviso de Descontinuação da API v1

Importante: A API v1 foi descontinuada e deixará de funcionar no final de fevereiro de 2026. Se você ainda está usando a API v1, migre para a API v2 o quanto antes.

Precisa de ajuda na migração? Consulte nossa documentação da API v2 ou entre em contato com nossa equipe de suporte.