---
title: "Realiza o cadastro de um novo lead"
method: POST
path: "/cvbot/lead"
tags: ["Leads"]
---

# Realiza o cadastro de um novo lead

`POST /cvbot/lead`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1`
- URL: `https://integracao.cvcrm.com.br/api/v1/cvbot/lead`
- Auth: none declared. Required headers: `email`, `token`

> 🔒 **Autenticação necessária**
>
> Esta API utiliza autenticação via **e-mail e token** nos headers da requisição.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token)

## Headers

- `email` string, required
- `token` string, required

## Request body

- CadastroLead
  - `nome` string
  - `email` string, required
  - `telefone` string, required

## Response `201`

Lead cadastrado com sucesso

- CadastroLeadSucesso
  - `idlead` integer: Retorna o id do lead.
  - `empreendimentos` object[]
    - `idempreendimento` integer: Retorna o id do empreendimento vinculado ao lead.
    - `nome` string: Retorna o nome do empreendimento vinculado ao lead.
  - `corretor` object[]
    - `idcorretor` integer
    - `nome` string
  - `imobiliaria` object[]
    - `idimobiliaria` integer
    - `nome` string
  - `gestor` object[]
    - `idgestor` integer
    - `nome` string

## Other responses

- `400`: Requisição Incorreta! Algum dos dados obrigatórios não foi informado ou foi informado de forma incorreta.
- `401`: E-mail e/ou token incorreto(s).
- `422`: Erro interno!

---

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