---
title: "Alterar situação do Lead"
method: POST
path: "/alterar-situacao-lead"
tags: ["Leads"]
---

# Alterar situação do Lead

`POST /alterar-situacao-lead`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/comunicador`
- URL: `https://integracao.cvcrm.com.br/api/v1/comunicador/alterar-situacao-lead`
- 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)

Altera a situação do lead

## Request body

- AlterasituacaoDoLead
  - `idlead` integer: Identificador do lead
  - `idsituacao` integer, required: Identificador da nova situação do lead
  - `idmotivo_cancelamento` integer: Identificador do motivo de cancelamento
  - `descricao_motivo_cancelamento` string: Descrição do motivo de cancelamento
  - `submotivo_cancelamento` string: Submotivo de cancelamento

## Response `200`

Sucesso

- RetornoAlterasituacaoDoLead
  - `sucesso` boolean
  - `mensagem` string

## Other responses

- `400`: Requisição inválida
- `401`: Request sem token de autorização
- `422`: Erro interno!

---

[API](https://skmtc.dev/cvcrm/apis/comunicador.md) - [All operations](https://skmtc.dev/cvcrm/apis/comunicador/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/comunicador/revisions/83f3c9ab22fa?raw)