---
title: "Realizar cadastro de um novo cliente"
method: POST
path: "/pessoa"
tags: ["Pessoa"]
---

# Realizar cadastro de um novo cliente

`POST /pessoa`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/cliente`
- URL: `https://integracao.cvcrm.com.br/api/v1/cliente/pessoa`
- Auth: none declared

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization, gerado pelo endpoint de autenticação do próprio Portal do Cliente: `POST /api/v1/cliente/autenticacao` (documento e senha do cliente) ou `POST /api/v1/cliente/autenticacao/sindico` (síndicos).
> ⚠️ O token de integração das APIs v2/v3 (`POST /api/v3/auth/token`) **não é válido** para o Portal do Cliente: ele não representa um cliente e as consultas retornarão vazias ou dados incorretos.

Realizar cadastro de um novo cliente

## Request body

- CadastroClienteRequest
  - `nome` string: Nome do cliente
  - `documento_tipo` string, required: Tipo do documento do cliente: cpf ou cnpj
  - `documento` string, required: Documento do cliente (com ou sem máscara)
  - `data_nasc` string: Data de nascimento do cliente (obrigatório para pessoas físicas)
  - `telefone` string, required: Telefone do cliente
  - `celular` string: Celular do cliente
  - `email` string, required: Email do cliente
  - `senha` string, required: Senha do cliente
  - `confirma` string, required: Confirmação da senha do cliente
  - `recaptcha_token` string, required
  - `pessoa_estrangeira` boolean: Informa se o documento é internacional

## Response `201`

Cadastro de cliente realizado com sucesso

- CadastroSucesso
  - `id` integer: Id criado
  - `sucesso` boolean

## Other responses

- `400`: Requisição incorreta!
- `422`: Erro interno ao realizar ação!

---

[API](https://skmtc.dev/cvcrm/apis/portal-do-cliente.md) - [All operations](https://skmtc.dev/cvcrm/apis/portal-do-cliente/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/portal-do-cliente/revisions/7d95f9678127?raw)