Skip to main content
POST
Criar ou atualizar cliente com dados completos
Cria ou atualiza o cliente com dados pessoais, endereço e dados profissionais em uma chamada. Depois dela, o cliente já pode simular e criar a proposta.
É o jeito mais simples de deixar o cadastro completo. Veja a visão geral de cliente.
Para atualizar um cliente já cadastrado, envie sem Idempotency-Key. Com a chave, a chamada só cria e retorna 409 se o CPF, o e-mail ou o celular já estiverem cadastrados.

Authorizations

Authorization
string
header
required

Cabeçalho de autenticação Bearer no formato Bearer <token> onde <token> é seu TOKEN de autenticação

Headers

Idempotency-Key
string

Chave opcional (1 a 200 caracteres) para repetir a requisição com segurança. Reenviar a mesma chave com o mesmo conteúdo devolve o resultado original sem duplicar o registro; reutilizá-la com outro conteúdo retorna erro.

Maximum string length: 200
Example:

"6f1c9a2e-3b7d-4e2a-9c51-0d8f3a7b2e10"

Body

application/json

Dados completos do cliente

celular
string
required

Telefone celular exatamente no formato +55 (DD) 99999-9999.

Minimum string length: 1
Example:

"+55 (11) 99876-5432"

cpf
string
required

CPF do cliente, com ou sem pontuação (11 dígitos). Os dígitos verificadores são validados.

Required string length: 11 - 14
Example:

"12345678909"

dataDeNascimento
string<date-time>
required

Data de nascimento em ISO-8601. O cliente precisa ter entre 18 e 75 anos.

Example:

"1990-05-20T00:00:00-03:00"

email
string
required

Endereço de e-mail do cliente.

Minimum string length: 1
Example:

"maria.souza@exemplo.com.br"

nome
string
required

Primeiro nome do cliente.

Minimum string length: 1
Example:

"Maria"

sobrenome
string
required

Sobrenome do cliente.

Minimum string length: 1
Example:

"Souza"

endereco
object
required
dadosProfissionais
object
required

Response

Cliente criado ou atualizado

id_cliente
string<uuid>

Identificador único do cliente

Example:

"123e4567-e89b-12d3-a456-426614174000"