---
title: "Adiciona uma associação de uma pessoa não cadastrada no sistema"
method: POST
path: "/associacoes/nova-pessoa"
tags: ["Associações de Pessoas"]
---

# Adiciona uma associação de uma pessoa não cadastrada no sistema

`POST /associacoes/nova-pessoa`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/cliente`
- URL: `https://integracao.cvcrm.com.br/api/v1/cliente/associacoes/nova-pessoa`
- Auth: HTTP bearer

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

## Request body

- CadastroAssociacaoNovaPessoa
  - `nome` string
  - `email` string
  - `documento` string
  - `documento_tipo` string
  - `telefone` string
  - `celular` string
  - `idtipo` integer
  - `unidades` object[]
    - `idunidade` integer

## Response `201`

Operação realizada com sucesso

- object
  - `idassociacao` integer
  - `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)