Painel
POST/v1/customers

Criar ou sincronizar cliente

Cria o cliente pelo documento ou reutiliza o cadastro existente sem apagar campos omitidos.

Request

json
{
  "document": "39053344705",
  "name": "Cliente Exemplo",
  "email": "financeiro@cliente.com",
  "municipality_code": "3550308",
  "address": {
    "street_type": "Rua",
    "street": "Exemplo",
    "number": "100",
    "district": "Centro",
    "zip_code": "01001000"
  }
}

Response

json
{ "id": "cus_...", "document": "39053344705", "name": "Cliente Exemplo", "origin": "api" }

O que observar

  • • document e name são obrigatórios.
  • • Esta rota é opcional: na emissão direta, envie customer com endereço completo.
  • • Para mudar um cadastro existente de propósito, use PATCH.