# Cadastrar lead

> Registra um contato (nome e e-mail ou WhatsApp) vindo de um formulário externo, como uma landing page.

Fonte: https://api.viashopmoda.com.br/docs-api/?p=recursos/leads/cadastrar · Atualizado em 18/11/2026


## O que faz

Cria um lead com origem "api". Recusa se já existir lead com o mesmo WhatsApp (DDI + número) ou o mesmo e-mail.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/leads/cadastrar/{TOKEN}` |
| **Corpo** | Objeto JSON `{ ... }`, cabeçalho `Content-Type: application/json` |
| **Token** | Substitua `{TOKEN}` pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |


## Campos

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `nome` | texto | **sim** | Nome do contato. |
| `email` | texto | **sim** | E-mail. |
| `whatsapp_ddi` | texto | **sim** | DDI, ex.: `55`. |
| `whatsapp_numero` | texto | **sim** | Número com DDD, ex.: `35988880101`. |
| `utm_source` | texto | não | Origem da campanha. |
| `utm_medium` | texto | não | Mídia. |
| `utm_campaign` | texto | não | Campanha. |

## Exemplo

Pela API, os quatro primeiros campos são obrigatórios (leads criados pela própria loja podem ter só e-mail ou só WhatsApp).

```json
{
  "nome": "Joana",
  "email": "joana@exemplo.com.br",
  "whatsapp_ddi": "55",
  "whatsapp_numero": "35988880101",
  "utm_source": "instagram",
  "utm_medium": "stories",
  "utm_campaign": "inverno"
}
```

Sucesso: `{"retorno": true, "msg": "Lead cadastrado com sucesso.", "id": "..."}`. Duplicado: `Lead já existe`.

## Pode reenviar?

Sim: o reenvio é recusado com "Lead já existe".
