Início rápido

Em 5 minutos você cria a conta, verifica um domínio, gera uma chave e manda o primeiro e-mail.

1. Crie a conta#

Entre em app.couryo.com com a sua conta Google. Toda conta começa no plano Grátis e no nível 0 (sandbox): até 25 e-mails por dia, só para os e-mails da própria conta, o suficiente para testar a integração (antes de verificar um domínio, use o remetente teste@sandbox.couryo.com). Veja os níveis de confiança.

2. Adicione e verifique o domínio#

No painel, em Domínios, adicione o domínio de onde os e-mails vão sair (por exemplo, exemplo.com.br).

• Usa a Cloudflare? Clique em Conectar Cloudflare. O Couryo cria os registros sozinho.
• Outro painel (Registro.br, por exemplo)? Copie cada registro mostrado na tela. O status de cada um atualiza ao vivo.

Quando DKIM, return path e DMARC estiverem certos, o domínio fica verified e a conta sobe para o nível 1 (100 por dia). Não é preciso mexer no SPF do domínio principal. O plano Grátis permite 1 domínio. Detalhes em Domínios e DNS.

3. Crie uma chave de API#

Em Chaves, crie uma chave com escopo send. A chave inteira aparece uma única vez: guarde no seu gerenciador de segredos ou no .env.

export COURYO_API_KEY="ck_live_..."

Quer testar sem entregar nada? Use uma chave ck_test_. Veja Modo de teste.

4. Envie#

curl https://api.couryo.com/v1/emails \
  -H "Authorization: Bearer $COURYO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: boas-vindas-usr-123" \
  -d '{
    "from": "Exemplo <oi@exemplo.com.br>",
    "to": ["voce@exemplo.com.br"],
    "subject": "Olá do Couryo",
    "html": "<p>Funcionou!</p>",
    "text": "Funcionou!"
  }'

const res = await fetch("https://api.couryo.com/v1/emails", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COURYO_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "boas-vindas-usr-123",
  },
  body: JSON.stringify({
    from: "Exemplo <oi@exemplo.com.br>",
    to: ["voce@exemplo.com.br"],
    subject: "Olá do Couryo",
    html: "<p>Funcionou!</p>",
    text: "Funcionou!",
  }),
});
console.log(res.status, await res.json());

A resposta é 202 Accepted:

{ "id": "msg_9w2k7c1x0d4e5f6g", "status": "queued" }

5. Acompanhe a entrega#

A chave send só envia. Para ler a linha do tempo, use uma chave com escopo read (ou abra o e-mail no painel):

curl https://api.couryo.com/v1/emails/msg_9w2k7c1x0d4e5f6g \
  -H "Authorization: Bearer $COURYO_READ_KEY"

O campo events traz cada etapa (accepted, queued, sent, delivered...) com horário, servidor de destino, código SMTP e uma explicação em linguagem simples. Veja Eventos e linha do tempo.

Próximos passos#

• Receba os eventos no seu sistema com webhooks.
• Evite envios duplicados com idempotência.
• Use o Couryo pelo seu agente de IA com o servidor MCP.
• Prefere não mexer no código? O SMTP chega em breve.

SDKs oficiais para Node e PHP estão a caminho. Até lá, qualquer cliente HTTP funciona, como nos exemplos acima.