Primeiro envio

Cadastre o domínio de onde você manda

Não é o domínio do seu site: é o do remetente. Use um subdomínio — news.suaempresa.com.br, mail.suaempresa.com.br — e não o domínio principal.O motivo é reputação. Se a sua newsletter e a sua redefinição de senha saem do mesmo domínio, uma campanha ruim derruba a entrega do e-mail que a pessoa está esperando na tela.

curl -X POST https://kourio.app/v1/domains \
  -H "Authorization: Bearer $KOURIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "news.suaempresa.com.br" }'

A resposta traz os registros DNS a publicar.

Publique o DNS

Se o domínio já tem SPF — comum com Google Workspace ou Microsoft 365 — não publique um segundo. Dois registros v=spf1 no mesmo nome são um permerror, e o domínio acaba sem SPF nenhum: o e-mail que você já manda hoje começa a falhar. Acrescente include:_spf.kourio.app ao registro que existe.

Depois de publicar, peça a conferência:

curl -X POST https://kourio.app/v1/domains/{id}/verify \
  -H "Authorization: Bearer $KOURIO_API_KEY"

Mande a primeira mensagem

curl -X POST https://kourio.app/v1/emails \
  -H "Authorization: Bearer $KOURIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Sua Empresa <pedidos@news.suaempresa.com.br>",
    "to": "cliente@example.com",
    "subject": "Seu pedido A-10428 saiu para entrega",
    "html": "<p>Chega amanhã até as 18h.</p>"
  }'

A resposta volta antes de a mensagem sair — ela entra na fila. Para saber se chegou, use o webhook ou consulte a mensagem depois.

Com o SDK

npm install @kourio/sdk

import { Kourio } from '@kourio/sdk';

const kourio = new Kourio(process.env.KOURIO_API_KEY!);

await kourio.emails.send({
  from: 'Sua Empresa <pedidos@news.suaempresa.com.br>',
  to: 'cliente@example.com',
  subject: 'Seu pedido A-10428 saiu para entrega',
  html: '<p>Chega amanhã até as 18h.</p>',
});

Começar

Enviar

Saber o que aconteceu

Conta

Integrações

Primeiro envio

Com o SDK

​Com o SDK

Com o SDK