> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendaki.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Envia o teu primeiro email transacional em poucos minutos.

## 1. Cria a tua API key

Entra em [app.sendaki.tech](https://app.sendaki.tech), abre **Settings → API Keys** e cria uma nova chave. Guarda-a num local seguro — é apresentada apenas uma vez.

<Warning>
  Nunca exponhas a tua API key no browser ou em repositórios públicos. Usa-a apenas a partir do teu backend.
</Warning>

## 2. Verifica o teu domínio de envio

O endereço `from` de qualquer email tem de pertencer a um domínio verificado. Isso é gerido no workspace, não pela API transacional: entra em [app.sendaki.tech](https://app.sendaki.tech) → **Settings → Domains**, adiciona o teu domínio e configura os registos DNS indicados lá.

<Note>
  Toda a tua organização já tem por defeito um subdomínio `{slug}.sendaki.tech` verificado — podes começar a enviar de imediato a partir dele enquanto verificas o teu próprio domínio.
</Note>

## 3. Envia o teu primeiro email

Depois do domínio ficar verificado no workspace, envia o teu primeiro email:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://awsapi.sendaki.tech/emails \
    -H "x-api-key: {a_tua_api_key}" \
    -H "Content-Type: application/json" \
    -d '{
      "from": "hello@meudominio.com",
      "to": ["destinatario@example.com"],
      "subject": "Olá!",
      "body": {
        "html": "<h1>Olá!</h1><p>O teu primeiro email via Sendaki.</p>",
        "text": "Olá! O teu primeiro email via Sendaki."
      }
    }'
  ```

  ```javascript Node.js theme={null}
  const res = await fetch("https://awsapi.sendaki.tech/emails", {
    method: "POST",
    headers: {
      "x-api-key": process.env.SENDAKI_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      from: "hello@meudominio.com",
      to: ["destinatario@example.com"],
      subject: "Olá!",
      body: {
        html: "<h1>Olá!</h1><p>O teu primeiro email via Sendaki.</p>",
        text: "Olá! O teu primeiro email via Sendaki.",
      },
    }),
  });

  const { message_id } = await res.json();
  ```

  ```python Python theme={null}
  import requests

  res = requests.post(
      "https://awsapi.sendaki.tech/emails",
      headers={"x-api-key": SENDAKI_API_KEY},
      json={
          "from": "hello@meudominio.com",
          "to": ["destinatario@example.com"],
          "subject": "Olá!",
          "body": {
              "html": "<h1>Olá!</h1><p>O teu primeiro email via Sendaki.</p>",
              "text": "Olá! O teu primeiro email via Sendaki.",
          },
      },
  )

  message_id = res.json()["message_id"]
  ```
</CodeGroup>

<Check>
  Resposta `201` com um `message_id` — o teu email está a caminho.
</Check>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Todos os casos de envio" icon="paper-plane" href="/guides/sending-emails">
    CC/BCC, reply-to, múltiplos destinatários e anexos.
  </Card>

  <Card title="Referência da API" icon="square-terminal" href="/api-reference/introduction">
    Todos os endpoints em detalhe.
  </Card>
</CardGroup>