---
title: "Criar Cliente"
method: POST
path: "/customers"
---

# Criar Cliente

`POST /customers`

Essa chamada cria um objeto cliente.
A propriedade zip_code realiza uma pré-consulta e valida se existe um endereço valido para o cliente, porém caso não seja retornado os dados do endereço completo do cliente, será apresentado um erro ao tentar criar o cliente informando que falta alguma informação, pois não conseguimos obter nessa pré consulta.

## Request body

- object
  - `email` string, required — Email do cliente
  - `name` string, required — Nome do cliente
  - `notes` string — Notas
  - `phone` integer — Número do Telefone - 9 dígitos
  - `phone_prefix` integer — Prefixo, apenas números - 3 dígitos (obrigatório caso preencha "phone")
  - `cpf_cnpj` string — CPF ou CNPJ do cliente. Obrigatório para emissão de boletos registrados. <br> **Aceito o campo alfanumérico apenas para CNPJ**.
  - `cc_emails` string — Endereços de E-mail para cópia separados por vírgula
  - `zip_code` string — CEP. Obrigatório para emissão de boletos registrados
  - `number` string — Número do endereço (obrigatório caso "zip_code" seja enviado).
  - `street` string — Rua. Obrigatório caso CEP seja incompleto.
  - `city` string — Cidade
  - `state` string — Estado
  - `district` string — Bairro. Obrigatório caso CEP seja incompleto.
  - `complement` string — Complemento de endereço. Ponto de referência.
  - `custom_variables` object[] — Variáveis Personalizadas
    - `name` string — Nome da variável
    - `value` string — Valor da variável

## Response `200`

200

- object
  - `id` string
  - `email` string
  - `name` string
  - `notes` string
  - `created_at` string
  - `updated_at` string
  - `cc_emails` unknown
  - `cpf_cnpj` string
  - `zip_code` string
  - `number` string
  - `complement` unknown
  - `phone` string
  - `phone_prefix` string
  - `custom_variables` object[]
    - `name` string
    - `value` string
  - `payment_methods` object[]
  - `default_payment_method_id` unknown
  - `proxy_payments_from_customer_id` unknown
  - `city` string
  - `state` string
  - `district` string
  - `street` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/versions/4590fc729d1e/schema)