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

# Atualizar interesses do lead

`PATCH /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)

Atualiza os interesses do lead. **Cada array enviado substitui totalmente o
conjunto atual daquele campo** (o que já estava associado e não está no novo
array é desassociado; o que está no array e ainda não associado é
associado). Envie um array vazio (`[]`) para remover todos os interesses
daquele campo. Campos **não enviados** no payload não são alterados. As
mesmas regras de validação do `POST` se aplicam (empreendimento/unidade
ativos e visíveis ao painel, unidade associa o empreendimento, produto por
nome cria se não existir). Ao menos um campo deve ser enviado.

## 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 `200`

Interesses do lead atualizados com sucesso.

- 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.
- `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/atualizado (ver descrição do POST).
- `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)