POST/v1/emails

Enviar email transacional

Envia um email individual em até 200 ms (p95). O corpo aceita HTML completo e uma versão em texto puro opcional. O envio retorna imediatamente com o ID do email em fila — acompanhe o ciclo de vida pelos eventos de entrega.

Parâmetros do corpo

Parâmetro	Tipo	Obrigatório	Descrição
from	string	sim	Remetente no formato Nome <email>. O domínio precisa estar verificado.
to	string[]	sim	Até 50 destinatários por chamada.
subject	string	sim	Assunto do email, máximo de 255 caracteres.
html	string	sim	Corpo em HTML. CSS inline é recomendado.
text	string	não	Versão em texto puro para clientes sem HTML.
reply_to	string	não	Endereço que recebe as respostas.

Exemplo de requisição

curl -X POST https://api.correio.dev/v1/emails \
  -H "Authorization: Bearer $CORREIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Loja Aurora <pedidos@aurora.com.br>",
    "to": ["ana.souza@exemplo.com"],
    "subject": "Seu pedido #4821 foi confirmado",
    "html": "<h1>Obrigado, Ana!</h1><p>Enviamos hoje.</p>"
  }'

Resposta · 202 Accepted

{
  "id": "em_9f3kq81xv204",
  "status": "queued",
  "from": "Loja Aurora <pedidos@aurora.com.br>",
  "to": ["ana.souza@exemplo.com"],
  "subject": "Seu pedido #4821 foi confirmado",
  "created_at": "2026-07-13T14:02:09Z"
}

Testar agora

sandbox

DestinatárioAssuntoCorpo

Preview do email

De: Loja Aurora <pedidos@aurora.com.br>

Para: ana.souza@exemplo.com

Seu pedido #4821 foi confirmado

Olá, Ana! Seu pedido foi confirmado e sai para entrega hoje. Acompanhe pelo painel da Loja Aurora.

Acompanhar pedido

Loja Aurora · Av. Paulista, 1000 · São Paulo, SP · Cancelar inscrição