# Início rápido

> Envie o primeiro e-mail pelo Couryo em 5 minutos, da criação da conta à linha do tempo da mensagem.

Fonte: https://couryo.com/docs/quickstart

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](https://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](https://couryo.com/docs/limits.md).

## 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](https://couryo.com/docs/domains.md).

## 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`.

```bash title="Terminal"
export COURYO_API_KEY="ck_live_..."
```

Quer testar sem entregar nada? Use uma chave `ck_test_`. Veja [Modo de teste](https://couryo.com/docs/test-mode.md).

## 4. Envie

```bash title="cURL"
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!"
  }'
```

```js title="Node.js"
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`:

```json title="Resposta"
{ "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):

```bash title="cURL"
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](https://couryo.com/docs/events.md).

## Próximos passos

- Receba os eventos no seu sistema com [webhooks](https://couryo.com/docs/webhooks.md).
- Evite envios duplicados com [idempotência](https://couryo.com/docs/sending.md#idempotencia).
- Use o Couryo pelo seu agente de IA com o [servidor MCP](https://couryo.com/docs/mcp.md).
- Prefere não mexer no código? O [SMTP](https://couryo.com/docs/smtp.md) chega em breve.

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