Skip to main content
POST /v1/emails envia um email transacional. Suporta texto simples, HTML, múltiplos destinatários, CC/BCC, reply-to e anexos.
O endereço from tem de pertencer a um domínio verificado. A verificação de domínios é feita no workspace (app.sendaki.tech → Settings → Domains), não por esta API.

Texto simples

HTML e texto (recomendado)

Envia sempre as duas versões — clientes de email sem suporte a HTML mostram a versão em texto.

Nome de exibição do remetente

Usa from_name para melhorar a entregabilidade — o Gmail penaliza remetentes sem nome de exibição.

Múltiplos destinatários

CC e BCC

Reply-To

Útil quando o from é um endereço noreply@ mas queres que as respostas cheguem a outra caixa.

Com anexos

Anexos são referenciados por attachment_id — faz o upload primeiro via Anexos, depois usa o attachment_id devolvido aqui.
Múltiplos anexos funcionam da mesma forma — basta adicionar mais entradas ao array.

Campos do body

Resposta

Guarda o message_id para correlacionar com eventos de entrega no teu próprio sistema.
Um domínio do from não verificado (ou que não pertence à tua organização) devolve 403, antes de sequer tentar o envio — ver Autenticação.
Cada organização tem um limite de envio por dia e por segundo, conforme o plano — ultrapassá-lo devolve 429. Ver Erros.
Ver todos os parâmetros, respostas e erros em POST /v1/emails.