🔒

Autenticação necessária

Esta API utiliza Bearer Token no header Authorization.
Consulte o tutorial completo antes de fazer sua primeira chamada:
Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)

Cadastra um novo lead com dados cadastrais mínimos. A obrigatoriedade de
email/telefone segue a configuração Campos obrigatórios no cadastro de
leads (obrigatorio_cadastro_leads, em
/gestor/configuracoes/configuracoesespecifico/leads): por padrão, exige ao
menos um dos dois, mas pode ser configurada para exigir e-mail, telefone, ou
ambos; o não atendimento à regra configurada retorna 400.
Dois leads não podem compartilhar o mesmo email, o mesmo telefone nem o
mesmo codigoInterno — a duplicidade retorna 400. telefone e
telefoneAlternativo já devem vir com o DDI incluso (ex.: +5579998877665);
quando o DDI é omitido, assume-se +55. nome assume
"Sem nome" quando omitido. idMidia precisa existir na base — se o ID
informado não existir, o campo é ignorado (não cria uma mídia nova).
origem ausente ou inválida é derivada do painel autenticado
(gestor → GE, imobiliaria → IM, corretor → CO, pdv → PV);
caso contrário, ND.

idTag, idEmpreendimento e idProduto associam o lead a registros
já existentes (apenas IDs — este endpoint não cria tag/produto por
nome). A validação é estrita: se qualquer ID informado não existir
(ou, no caso de empreendimento/produto, não estiver ativo), a
requisição inteira é rejeitada com 400 e nada é persistido —
diferente do comportamento tolerante de /leads/{idLead}/interesses.
Associar idProduto pode cascatear automaticamente o(s)
empreendimento(s) ao qual o produto está vinculado (mesmo
comportamento herdado de /interesses). Não existe campo de região
no cadastro do lead: ela é sempre calculada a partir do(s)
empreendimento(s) associados (ver GET /leads/{idLead}).