---
title: "Adicionar interesses do lead"
method: POST
path: "/leads/{idLead}/interesses"
tags: ["Interesses do Lead"]
---

# Adicionar interesses do lead

`POST /leads/{idLead}/interesses`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v4/comercial`
- URL: `https://integracao.cvcrm.com.br/api/v4/comercial/leads/{idLead}/interesses`
- Auth: HTTP bearer

> 🔒 **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)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-nas-apis-do-cv-crm-com-bearer-token)

Adiciona empreendimento(s), unidade(s) e/ou produto(s) de interesse ao lead, e
opcionalmente atualiza o motivo de escolha. **Sempre aditivo**: nunca remove
interesses já associados — para substituir o conjunto, use `PATCH`. Todos os
campos são opcionais, mas ao menos um precisa ser enviado.

- `idEmpreendimento`: associa apenas os empreendimentos ativos e visíveis ao
  painel autenticado; os demais são reportados em `naoAssociados`.
- `idUnidade`: associa apenas unidades ativas e visíveis ao painel (unidade,
  bloco e etapa precisam estar todos ativos/visíveis); o empreendimento da
  unidade também é associado automaticamente como interesse.
- `idProduto`/`produto`: duas formas independentes de referenciar produtos —
  envie apenas a que fizer sentido para o seu caso (não é necessário enviar
  as duas). `idProduto` aceita IDs de produtos já existentes e ativos;
  `produto` aceita nomes e cria o produto automaticamente quando o nome
  ainda não existe. Se as duas forem enviadas na mesma requisição, devem se
  referir a produtos diferentes — cada uma é resolvida de forma
  independente. Produtos vinculados a empreendimentos também associam
  esses empreendimentos automaticamente.
- `idMotivoEscolha`: precisa existir e estar ativo, senão é reportado em
  `naoAssociados` sem bloquear os demais campos do mesmo request.

Se nenhum item do payload puder ser associado/atualizado, a resposta é 422.
Se ao menos um item for processado com sucesso, a resposta é 201 e os itens
rejeitados aparecem em `data.naoAssociados` (chave presente apenas quando há
rejeição parcial).

## Path parameters

- `idLead` integer, required

## Request body

- CriarOuAtualizarLeadInteresses: Todos os campos são opcionais — ao menos um deve ser enviado.
  - `idEmpreendimento` integer[]: IDs de empreendimentos de interesse. No POST, somam-se aos já associados; no PATCH, substituem o conjunto atual.
  - `idUnidade` integer[]: IDs de unidades de interesse. O empreendimento de cada unidade também é associado automaticamente.
  - `idProduto` integer[]: IDs de produtos já existentes e ativos.
  - `produto` string[]: Nomes de produtos de interesse. Cria o produto automaticamente quando o nome ainda não existe.
  - `idMotivoEscolha` integer: ID do motivo de escolha do empreendimento. Precisa existir e estar ativo.

## Response `201`

Interesse(s) adicionado(s) com sucesso ao lead.

- RetornoLeadInteresses
  - `status` string, required
  - `code` integer, required
  - `data` object, required
    - `idLead` integer, required: ID do lead
    - `naoAssociados` object, nullable: Presente apenas quando algum item do payload não pôde ser associado/atualizado. Chaveado pelo campo de origem (idEmpreendimento, idUnidade, idProduto, idMotivoEscolha), contendo os itens rejeitados ou uma mensagem explicativa.

## Other responses

- `400`: Dados inválidos: nenhum campo de interesse foi enviado no payload, ou campo com formato inválido (ex.: idEmpreendimento não é array).
- `401`: Token inválido ou não informado.
- `403`: Usuário autenticado sem permissão para gerenciar interesses de leads.
- `404`: Lead inexistente.
- `422`: Nenhum item do payload pôde ser associado: empreendimento(s)/unidade(s) inativos ou invisíveis ao painel, produto inexistente, ou motivo de escolha inexistente/inativo.
- `429`: Limite de requisições excedido (rate limit).
- `500`: Erro interno do servidor.

---

[API](https://skmtc.dev/cvcrm/apis/interesses-do-lead.md) - [All operations](https://skmtc.dev/cvcrm/apis/interesses-do-lead/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/interesses-do-lead/revisions/273a2f259d7d?raw)