---
title: "Cadastra corretor."
method: POST
path: "/cadastros/corretores"
tags: ["Corretor"]
---

# Cadastra corretor.

`POST /cadastros/corretores`

> 🔒 **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)

Essa integração coleta informações de requisições realizadas por sistemas legados e verifica se o dado inserido no campo documento ou idcorretor_int (identificador do sistema legado) existe ou não no Construtor de Vendas. Se já existir um corretor cadastrado com o mesmo documento ou identificador, essa API irá atualizar os dados solicitados na requisição, senão irá cadastrá-los. **Obs: Para esta verificação, o documento CPF deve ser válido. Somente será aceito um cadastro por CPF.**

## Headers

- `email` string, required — E-mail para autenticação do usuário em cadastro de corretor
- `token` string, required — Token para autenticação do usuário em cadastro de corretor

## Request body

- CadastroCorretor — Informações no formato JSON do corretor a ser cadastrado.
  - `idcorretor_int` string — Identificador do Corretor no sistema legado.
  - `documento` string, required — Documento CPF do Corretor.
  - `nome` string, required — Nome do Corretor.
  - `sexo` string, required — Sexo do Corretor.
  - `data_nasc` string, required — Data de nascimento do Corretor.
  - `data_emissao_rg` string — Data de emissão do RG do Corretor.
  - `ddi_telefone` string — DDI do Telefone do Corretor.
  - `telefone` string, required — Telefone do Corretor.
  - `cep` string — CEP do corretor.
  - `logradouro` string — Logradouro do Endereço.
  - `endereco` string — Endereço do Corretor.
  - `bairro` string — Bairro do Corretor.
  - `numero` string — Número do Endereço do Corretor.
  - `complemento` string — Complemento do Corretor.
  - `cidade` string — Cidade do Corretor.
  - `estado` string — Estado do Corretor.
  - `creci` string, required — CRECI do Corretor.
  - `notificar_novos_leads` string, required — Informar o Aviso das notificações do Lead.
  - `tipo_conta` string — Tipo de Conta.
  - `banco` string — Nome do banco.
  - `nome_agencia` string — Nome da Agência.
  - `numero_agencia` string — Número da Agência.
  - `digito_agencia` string — Dígito da Agência.
  - `numero_conta` string — Número da Conta.
  - `digito_conta` string — Dígito da Conta.
  - `cpf_favorecido` string — Documento do Favorecido da Conta.
  - `nome_favorecido` string — Nome do Favorecido da Conta.
  - `idimobiliaria_int` string — Identificador da imobiliária que o corretor é vinculado.
  - `idimobiliaria` integer — Identificador da imobiliária que o corretor é vinculado no CV.
  - `email` string, required — E-mail do Corretor.
  - `ativo_login` string — Informa se poderá se relacionar com outras funcionalidades (S ou N).
  - `remover` string — Identificador do corretor que deseja remover. Só informar caso queira remover.

## Response `200`

Cadastro de corretor realizado com sucesso.

- CadastroCorretorSucesso — Retorna mensagem de corretor cadastrado com sucesso.
  - `codigo` string
  - `mensagem` string

## Other responses

- `400` — Requisição de cadastro de corretor inválida!

---

[API](https://skmtc.net/cvcrm/apis/clientes.md) · [All operations](https://skmtc.net/cvcrm/apis/clientes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cvcrm/clientes/versions/42bf5add8bf3/schema)