---
title: "Associar responsável ao lead"
method: POST
path: "/leads/{idLead}/responsaveis"
tags: ["Responsáveis do Lead"]
---

# Associar responsável ao lead

`POST /leads/{idLead}/responsaveis`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v4/comercial`
- URL: `https://integracao.cvcrm.com.br/api/v4/comercial/leads/{idLead}/responsaveis`
- 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)

Associa um responsável ao lead para o tipo informado. Se já existir um responsável
ativo desse tipo, ele é substituído (troca) — o anterior é registrado como perda,
com motivo atribuído automaticamente pelo backend (não é um campo do body).

Quando `tipoAtendente=corretor`, a imobiliária do corretor é associada
automaticamente junto (ver descrição da API acima) — não envie `idImobiliaria`.

## Path parameters

- `idLead` integer, required

## Request body

- object
  - `tipoAtendente` 'gestor' | 'corretor' | 'imobiliaria', required: Tipo de responsável a ser associado
  - `idUsuario` integer, required: Identificador do usuário (gestor/corretor/imobiliária) a associar

## Response `201`

Responsável associado ao lead

- object
  - `status` string
  - `code` integer
  - `data` object
    - `idLead` integer
    - `tipoAtendente` string
    - `idUsuario` integer
    - `idImobiliaria` integer: Só aparece quando tipoAtendente=corretor (imobiliária do corretor, associada automaticamente). Ausente para gestor/imobiliaria.

## Other responses

- `400`: Falha de validação de campo (ex. tipoAtendente fora do enum, idUsuario ausente)
- `401`: Token JWT ausente ou inválido
- `403`: Usuário autenticado sem permissão para a operação. Para o painel Imobiliária com corretores associados ativos: `imobiliaria_com_corretores_associados_nao_pode_associar` (qualquer `POST`) ou `imobiliaria_com_corretores_associados_nao_pode_remover_gestor` (`DELETE` de `gestor`) — ver seção "Usuário Imobiliária com corretores associados" acima.
- `404`: Lead não encontrado ou sem acesso pelo usuário autenticado
- `422`: tipoAtendente=corretor e o corretor informado não tem imobiliária cadastrada — regra de negócio, não falha de validação de payload (ver 400 acima).

---

[API](https://skmtc.dev/cvcrm/apis/api-respons-veis-pelo-lead.md) - [All operations](https://skmtc.dev/cvcrm/apis/api-respons-veis-pelo-lead/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/api-respons-veis-pelo-lead/revisions/0d9ca3d69209?raw)