Pular para o conteúdo
E-mail transacional e marketing

Enviar e-mails pela API HTTPS

Um POST com sua chave de API: campos, idempotência e o que significa cada resposta.

  1. Em E-mail Transacional → API e SMTP, toque em Nova credencial e escolha Chave de API.
  2. Copie na hora: não mostramos de novo. Guarde como variável de ambiente do seu sistema, nunca no código do navegador.
  3. Envie um POST como o de baixo, com um remetente de um domínio verificado.

Exemplo

URL
https://fodenflow.com/api/v1/envios/mensajes
Cabeçalhos
Authorization: Bearer ffe_… Content-Type: application/json Idempotency-Key: pedido-1001
Corpo
{"from":"Minha Loja <[email protected]>","to":["[email protected]"],"subject":"Recebemos seu pedido","html":"<p>Obrigado!</p>","text":"Obrigado!","reply_to":"[email protected]","tags":["pedido"]}

Campos

  • from: "Nome <end@seudominio>" (domínio verificado).
  • to: um endereço ou uma lista de até 50 (cada um é um envio separado).
  • subject e html ou text (ou os dois), até 1 MB no total.
  • reply_to, tags (até 10) e headers (só X-… e List-Unsubscribe), opcionais.

Respostas

  • 202: na fila. Devolve o id de cada destinatário; consulte o status com GET /api/v1/envios/mensajes/<id>.
  • 401: chave errada ou revogada. 403: remetente sem verificar ou conta pausada.
  • 429: você chegou a um limite (do mês, do dia ou por minuto): a mensagem diz qual.
  • 413: o conteúdo é grande demais.

Com Idempotency-Key você pode tentar de novo sem medo: durante 24 horas, a mesma chave devolve a mesma resposta e não duplica o e-mail.

Pergunte ao assistente

Ficou alguma dúvida sobre isso? Pergunte ao assistente.

Este artigo ajudou?

Artigos relacionados

Não encontrou o que procurava?

Do outro lado há pessoas que conhecem sua conta. Escolha como prefere falar com a gente.

Status do sistemaAlgo não funciona? Veja se há um problema geral.