---
title: "Cadastra um cliente no BS2."
method: POST
path: "/pj/apibanking/forintegration/v1/onboarding/parceiros/clientes/cadastrar"
tags: ["Clientes"]
---

# Cadastra um cliente no BS2.

`POST /pj/apibanking/forintegration/v1/onboarding/parceiros/clientes/cadastrar`

## Request

- The document declares no server URL.
- Auth: none required

## Headers

- `x-bs2-client-id` string, required
- `x-bs2-correlation-id` string, required
- `apiKey` string, required

## Request body

- Bs2BfiOnboardingParceirosCadastrarCliente
  - `cpf` string, required: Descrição: CPF do Cliente MaxLength: 14 Campo Obrigatório
  - `apelido` string, nullable: Descrição: Apelido do Cliente MaxLength: 100
  - `nomeCompleto` string, required: Descrição: Nome Completo do Cliente MaxLength: 300 Campo Obrigatório
  - `nomeMae` string, required: Descrição: Nome da Mãe do Cliente MaxLength: 300 Campo Obrigatório
  - `dataNascimento` string, date, required: Descrição: Data de Nascimento do Cliente no formato: 'AAAA-MM-DD' Campo Obrigatório
  - `nacionalidade` string, required: Descrição: Nacionalidade do Cliente MaxLength: 100 Campo Obrigatório
  - `naturalidadeUF` string, nullable: Descrição: Estado referente a Nacionalidade do Cliente MaxLength: 2 Campo Obrigatório se Nacionalidade for Brasileiro
  - `naturalidade` string, nullable: Descrição: Cidade referente a Nacionalidade do Cliente MaxLength: 100 Campo Obrigatório se Nacionalidade for "Brasileiro"
  - `usPerson` boolean: Descrição: Para casos em que o cliente possua cidadania americana, informar "true"
  - `email` string, required: Descrição: E-mail do Cliente MaxLength: 300 Campo Obrigatório
  - `tipDocumento` 'RG' | 'CNH': Descrição: Tipo do documento do cliente
  - `numeroDocumento` string, nullable: Descrição: Número do documento CNH ou RG MaxLength: 50
  - `orgaoExpedidor` string, required: Descrição: Orgao Expedidor se CNH ou RG MaxLength: 30 Campo Obrigatório
  - `dataExpedicao` string, date, required: Descrição: Data de emissão se RG ou CNH no formato: 'AAAA-MM-DD' Campo Obrigatório
  - `ufExpedicao` string, required: Descrição: Estado de emissão se CNH ou RG MaxLength: 2 Campo Obrigatório
  - `cep` string, required: Descrição: CEP do Cliente MaxLength: 8 Campo Obrigatório
  - `logradouro` string, required: Descrição: Endereço do Cliente MaxLength: 300 Campo Obrigatório
  - `numero` integer, nullable: Descrição: Número do Endereço do Cliente MaxLength: 300 Campo Obrigatório
  - `complemento` string, nullable: Descrição: Complemento do Endereço do Cliente MaxLength: 20
  - `bairro` string, required: Descrição: Bairro do Endereço do Cliente MaxLength: 100 Campo Obrigatório
  - `cidade` string, required: Descrição: Cidade do Endereço do Cliente MaxLength: 100 Campo Obrigatório
  - `uf` string, required: Descrição: Estado do Endereço do Cliente MaxLength: 2 Campo Obrigatório
  - `ddi` string, required: Descrição: DDI do Telefone do Cliente MaxLength: 4 Campo Obrigatório
  - `ddd` string, required: Descrição: DDD do Telefone do Cliente MaxLength: 3 Campo Obrigatório
  - `telefone` integer, required: Descrição: Telefone Celular do Cliente Campo Obrigatório
  - `trabalha` boolean, required: Descrição: Se trabalha true para sim ou false para não Campo Obrigatório
  - `profissao` string, required: Descrição: Categoria profissional na qual o Cliente se enquadra, seguindo padrão de classificação MaxLength: 300 Campo Obrigatório
  - `renda` 'TresMil' | 'SeisMil' | 'DezMil' | 'VinteMil' | 'AcimaVinteMil', required: Faixa de renda do Cliente Campo Obrigatório

## Response `200`

OK

- Bs2BfiOnboardingParceirosClienteAdicionado
  - `id` string, uuid, nullable

## Other responses

- `201`: O dado foi criado.
- `400`: A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.
- `401`: A requisição não foi autorizada.
- `404`: Not Found

---

[API](https://skmtc.dev/bs2/apis/onboarding-ci-pf-bfi-parceiros.md) - [All operations](https://skmtc.dev/bs2/apis/onboarding-ci-pf-bfi-parceiros/llms.txt) - [OpenAPI document](https://skmtc.dev/bs2/apis/onboarding-ci-pf-bfi-parceiros/revisions/9fd6163c6f30?raw)