Skip to main content
POST
Registrar Cliente

Visão Geral

Registra um cliente para a conta autenticada. Se já existir um cliente global com o mesmo document (CPF ou CNPJ) — vinculado a outro seller — a Garu não cria um registro duplicado: reaproveita o cliente global e cria (ou atualiza) o seu próprio perfil vinculado a ele.
Dedup por documento, não por e-mail. Dois sellers podem cadastrar o mesmo CPF com e-mails diferentes; cada um enxerga seu próprio perfil (nome, e-mail, telefone) para esse cliente, sem vazar dados do outro seller.

Headers

string
required
Sua chave de API (Bearer sk_live_...)
string
required
application/json
string
Opcional. Chave única para reenviar a requisição com segurança sem criar um cliente duplicado. A mesma chave devolve o cliente originalmente criado/casado por 24h, por vendedor.

Request Body

string
required
Nome completo
string
required
E-mail válido
string
required
CPF (11 dígitos) ou CNPJ (14 dígitos), apenas números
string
required
Telefone com DDD, 10 ou 11 dígitos, apenas números
string
required
fisica ou juridica
string
CEP com 8 dígitos, sem hífen
string
Logradouro
string
Número do endereço
string
Complemento
string
Bairro
string
Cidade
string
Sigla do estado, 2 letras maiúsculas (ex: SP)

Exemplo de Requisição

Resposta de Sucesso (201 Created)

billingEmail é o e-mail resolvido para envios de cobrança: billingEmailOverride (se definido) → e-mail deste perfil → e-mail global do cliente. Veja Definir e-mail de cobrança.

Erros

Próximos passos