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.

key · string · required

Sua chave de API de conteúdo (também aceita via ?key= ou header x-api-key).

data · object · required

Os campos do formulário (qualquer objeto: { nome, email, mensagem, … }).

gotcha · string

Campo honeypot anti-spam. Deixe oculto no formulário; se um bot preenchê-lo, a submissão é aceita silenciosamente e descartada.

curl

curl -X POST "https://api.citou.me/cd/forms/contato" \
  -H "content-type: application/json" \
  -d '{
    "key": "SUA_CHAVE",
    "data": { "nome": "Maria", "email": "[e-mail]", "mensagem": "Quero saber mais" }
  }'

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
  }),
});

Resposta

{ "ok": true }

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.

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