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

# Criar lead por webhook

> POST /webhook/leads abre um lead no funil a partir de um contato, com o JWT da conta.

```text theme={null}
POST /webhook/leads?workspaceId=ID_DO_FUNIL
Authorization: Bearer SEU_JWT
```

`workspaceId` vai na query e identifica o funil. O corpo leva a empresa, o usuário e o contato.

## Corpo

Obrigatórios:

* `companyId` e `userId`, UUIDs da sessão
* `contact.name`

Opcionais mais usados:

* `title`
* `stage`: `won`, `lost` ou `delete`
* `reason` e `categoryReasonId`
* `contact.emails`, `contact.phones`, `contact.notes`
* `contact.organization` ou `organization` no raiz, quando o lead já nasce ligado a uma empresa

E-mail fora do formato volta com o código `EMAIL_FORMAT_INVALID`.

```json theme={null}
{
  "companyId": "UUID_DA_EMPRESA",
  "userId": "UUID_DO_USUARIO",
  "title": "Interesse no plano anual",
  "contact": {
    "name": "Ana Lima",
    "emails": [{ "email": "ana@exemplo.com", "type": "work" }],
    "phones": [{ "phone": "+5511999999999", "type": "mobile" }]
  }
}
```

A resposta de sucesso segue `{ "success": true, "data": ... }`. Funil ou coluna inexistente responde 404. Corpo inválido responde 400. JWT ausente responde 401.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.