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

# Formulários (captura de leads)

> Envie submissões de formulário do seu site para a citou — elas chegam na sua caixa de leads.

O único endpoint de **escrita** da API de entrega. O seu site é dono do formulário (HTML) e
**envia as submissões** para a citou, que as armazena e mostra numa caixa de entrada de leads no
painel. Assim você captura leads sem manter um backend próprio.

`POST /cd/forms/{formKey}`

O `formKey` é um rótulo livre que você escolhe (ex.: `contato`, `ebook`) — dá para ter vários
formulários por marca.

<ParamField body="key" type="string" required>
  Sua chave de API de conteúdo (também aceita via `?key=` ou header `x-api-key`).
</ParamField>

<ParamField body="data" type="object" required>
  Os campos do formulário (qualquer objeto: `{ nome, email, mensagem, … }`).
</ParamField>

<ParamField body="gotcha" type="string">
  Campo **honeypot** anti-spam. Deixe oculto no formulário; se um bot preenchê-lo, a submissão é
  aceita silenciosamente e **descartada**.
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST "https://api.citou.me/cd/forms/contato" \
    -H "content-type: application/json" \
    -d '{
      "key": "SUA_CHAVE",
      "data": { "nome": "Maria", "email": "maria@exemplo.com", "mensagem": "Quero saber mais" }
    }'
  ```

  ```js JavaScript theme={null}
  await fetch("https://api.citou.me/cd/forms/contato", {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify({
      key: "SUA_CHAVE",
      data: { nome, email, mensagem },
      gotcha: honeypotValue, // vazio para humanos
    }),
  });
  ```
</CodeGroup>

```json Resposta theme={null}
{ "ok": true }
```

<Tip>
  Adicione um campo escondido (ex.: `<input name="gotcha" style="display:none" tabindex="-1" />`)
  e envie o valor em `gotcha`. Bots costumam preencher tudo; humanos deixam vazio.
</Tip>

Os leads aparecem no painel em **Conteúdo → Formulários**.