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

# Criar cliente

`POST /customers`

## Request body

- object
  - `name` string — Nome do cliente. Max: 64 caracteres.
  - `email` string — E-mail do cliente. Max: 64 caracteres
  - `code` string — Código de referência do cliente no sistema da loja. Max: 52 caracteres
  - `document` string — CPF, CNPJ ou PASSPORT do cliente. Max: 16 caracteres para CPF e CNPJ e Max: 50 caracteres para PASSPORT
  - `document_type` string — Tipo de documento. Valores possíveis: CPF, CNPJ ou PASSPORT.
  - `type` string — Tipo de cliente. Valores possíveis: **individual** (pessoa física) ou **company** (pessoa jurídica).<br>**Obrigatório**, caso o `document` seja enviado.
  - `gender` string — Sexo do cliente . Valores possíveis: **male** ou **female**
  - `address` object — Endereço do cliente.
    - `country` string — País (Código do país no formato ISO 3166-1 alpha-2)(2 digitos)
    - `state` string — Estado (Código do estado no formato ISO 3166-2).
    - `city` string — Cidade.
    - `zip_code` string — Código Postal (CEP) (Apenas numérico).
    - `line_1` string — Dados principais do endereço. Neste campo deve ser informado Número, Rua, Bairro, nesta ordem e separados por vírgula.
    - `line_2` string — Dados complementares do endereço. Neste campo pode ser informado complemento, referências.
  - `phones` object — Telefones do cliente. [Saiba mais sobre o telefones](https://docs.pagar.me/reference#telefones-1)
    - `home_phone` object — Telefone residencial do cliente.
      - `country_code` string — Código do País (Apenas numérico).
      - `area_code` string — Código da área (Apenas numérico).
      - `number` string — Número do telefone (Apenas numérico).
    - `mobile_phone` object — Telefone celular do cliente.
      - `country_code` string — Código do País (Apenas numérico).
      - `area_code` string — Código da área (Apenas numérico).
      - `number` string — Número do telefone (Apenas numérico).
  - `birthdate` string, date — Data de nascimento do cliente.
  - `metadata` string — Objeto chave/valor utilizado para armazenar informações adicionais sobre o cliente. [Saiba mais sobre metadata](https://docs.pagar.me/reference/metadata-1)

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `email` string
  - `code` string
  - `document` string
  - `document_type` string
  - `type` string
  - `gender` string
  - `delinquent` boolean
  - `address` object
    - `id` string
    - `line_1` string
    - `line_2` string
    - `zip_code` string
    - `city` string
    - `state` string
    - `country` string
    - `status` string
    - `created_at` string
    - `updated_at` string
  - `created_at` string
  - `updated_at` string
  - `birthdate` string
  - `phones` object
    - `home_phone` object
      - `country_code` string
      - `number` string
      - `area_code` string
    - `mobile_phone` object
      - `country_code` string
      - `number` string
      - `area_code` string
  - `metadata` object
    - `id` string
    - `company` string

## Other responses

- `422` — 422

---

[API](https://skmtc.net/pagar/apis/pagarme-api.md) · [All operations](https://skmtc.net/pagar/apis/pagarme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagar/pagarme-api/versions/dababf062743/schema)