Audácia
← Voltar ao portal Developers
Developers / Cadastros / Cadastro de clientes via API

Cadastro de clientes

Endpoint: POST /api/v1/customers
Permissão: customers.create

curl -X POST 'https://audacia.com.br/api/v1/customers' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{"name":"Cliente Exemplo","type":"F","mobile":"11999999999"}'

Os campos obrigatórios confirmados no contrato são:

Campo Tipo Regra
name texto 3 a 255 caracteres
type texto F (pessoa física) ou J (pessoa jurídica)

Há campos opcionais como code, taxvat, email, telephone, mobile, credit_limit, addresses. O CPF/CNPJ é normalizado quando fornecido; endereços possuem validações adicionais.

Em sucesso, a criação responde com HTTP 201, success: true e data. Antes de repetir um cadastro, consulte por documento ou código para evitar duplicidades.