---
title: "Cadastra uma pessoa."
method: POST
path: "/v3/cadastros/pessoas"
tags: ["Pessoas"]
---

# Cadastra uma pessoa.

`POST /v3/cadastros/pessoas`

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

Cadastra uma nova pessoa no sistema. O documento (CPF ou CNPJ) deve ser único e válido. Telefone e celular recebem DDI +55 automaticamente caso não informado e possuam 10 ou 11 dígitos.

## Request body

- CriarPessoaRequest
  - `nome` string, required — Nome completo da pessoa.
  - `codigointerno` string — Código interno da pessoa no sistema legado.
  - `documento` string, required — CPF ou CNPJ da pessoa (somente dígitos).
  - `documentoTipo` 'cpf' | 'cnpj', required — Tipo do documento. Valores aceitos: cpf, cnpj.
  - `dataNasc` string, date — Data de nascimento (formato YYYY-MM-DD).
  - `rg` string — RG da pessoa.
  - `rgOrgaoEmissor` string — Órgão emissor do RG.
  - `rgDataEmissao` string, date — Data de emissão do RG (formato YYYY-MM-DD).
  - `sexo` 'M' | 'F' | 'NDI' | 'A' — Gênero da pessoa. Valores aceitos: M - Masculino; F - Feminino; NDI - Não Desejo Informar; A - Ambos.
  - `email` string, email, required — E-mail para contato.
  - `telefone` string, required — Telefone para contato. DDI +55 é adicionado automaticamente para números com 10 ou 11 dígitos.
  - `celular` string — Celular para contato. DDI +55 é adicionado automaticamente para números com 10 ou 11 dígitos.
  - `rendaFamiliar` number — Renda familiar mensal em R$.
  - `estadoCivil` integer — Estado civil. Valores aceitos: 1 - Casado(a) comunhão parcial; 2 - Divorciado(a); 3 - Separado(a); 4 - Solteiro(a); 5 - Viúvo(a); 6 - Outro(s); 7 - União estável; 8 - Casado(a) comunhão total; 9 - Casado(a) separação total; 10 - Participação final nos aquestos; 11 - Separação obrigatória de bens.
  - `dataCasamento` string, date — Data de casamento (formato YYYY-MM-DD).
  - `pais` string — País de residência. Aceita ID numérico, nome ou sigla ISO (ex: BR).
  - `estado` string — Estado de residência. Aceita ID numérico, nome ou UF.
  - `cidade` string — Cidade de residência. Aceita ID numérico ou nome.
  - `logradouro` string — Logradouro do endereço. Aceita ID numérico ou nome.
  - `cep` string — CEP do endereço (8 dígitos).
  - `endereco` string — Endereço de residência.
  - `bairro` string — Bairro de residência.
  - `numero` string — Número do endereço.
  - `complemento` string — Complemento do endereço.
  - `naturalidade` string — Naturalidade da pessoa.
  - `filiacaoPai` string — Nome do pai.
  - `filiacaoMae` string — Nome da mãe.
  - `profissao` string — Profissão da pessoa.
  - `observacoes` string — Observações sobre a pessoa.
  - `inscEstadual` string — Inscrição estadual (pessoas jurídicas).
  - `inscMunicipal` string — Inscrição municipal (pessoas jurídicas).
  - `ativoLogin` boolean — Define se a pessoa pode realizar login no portal.
  - `idclassificacao` integer — ID da classificação (ex: VIP).
  - `dataPrimeiraHabilitacaoCnh` string, date — Data da primeira habilitação CNH (formato YYYY-MM-DD).
  - `dataFimValidadeCnh` string, date — Data de validade da CNH (formato YYYY-MM-DD).
  - `trabalhoNomeEmpresa` string — Nome da empresa em que trabalha.
  - `trabalhoCep` string — CEP da empresa.
  - `trabalhoEndereco` string — Endereço da empresa.
  - `trabalhoBairro` string — Bairro da empresa.
  - `trabalhoNumero` string — Número do endereço da empresa.
  - `complementoTrabalho` string — Complemento do endereço da empresa.
  - `trabalhoEstado` string — Estado da empresa. Aceita ID numérico, nome ou UF.
  - `trabalhoCidade` string — Cidade da empresa. Aceita ID numérico ou nome.
  - `logradouroTrabalho` string — Logradouro da empresa. Aceita ID numérico ou nome.
  - `trabalhoTelefone` string — Telefone da empresa.

## Response `201`

Pessoa cadastrada com sucesso.

- CriarPessoaResponse
  - `status` string
  - `code` integer
  - `data` object
    - `id` integer — ID da pessoa criada.

## Other responses

- `400` — Dados inválidos ou documento já cadastrado.
- `500` — Erro inesperado.

---

[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)