Criar lead por webhook - KingLog

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.

{
  "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.