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

# Criar um cliente

`POST /customers/create`

Permite que você crie um cliente para a sua loja.

**Campo obrigatório**: Apenas o `email` é obrigatório para criar um cliente.

**Recomendado**: Embora os demais campos sejam opcionais, é altamente recomendado fornecer `name`, `cellphone`, `taxId` e `zipCode` quando disponíveis, pois essas informações melhoram a experiência do cliente no checkout e facilitam a identificação.

## Request body

- object — Os dados do seu cliente. **Obrigatório**: Apenas `email` é obrigatório. **Opcional mas recomendado**: `name`, `cellphone`, `taxId`, `zipCode` e `metadata` são opcionais, mas recomendados para melhor experiência do cliente.
  - `email` string, required — E-mail do cliente (obrigatório)
  - `name` string — Nome completo do seu cliente (opcional)
  - `cellphone` string — Celular do cliente (opcional)
  - `taxId` string — CPF ou CNPJ válido do cliente (opcional)
  - `zipCode` string — CEP do cliente (opcional)
  - `metadata` object — Metadados adicionais do cliente. Campo livre para a sua aplicação (opcional)

## Response `200`

Cliente criado com sucesso.

- object
  - `data` Customer — Os dados do seu cliente.
    - `id` string, required — Identificador único público do cliente
    - `devMode` boolean, required — Indica se o cliente foi criado em ambiente de testes.
    - `name` string, required — Nome completo do cliente
    - `cellphone` string, required — Celular do cliente
    - `email` string, required — E-mail do cliente
    - `taxId` string, required — CPF ou CNPJ do cliente
    - `country` string — País do cliente
    - `zipCode` string — CEP do cliente
    - `metadata` object — Metadados adicionais do cliente
  - `error` string, nullable
  - `success` boolean — Se a requisição obteve sucesso ou não.

## Other responses

- `401` — Não autorizado. Falha na autenticação.

---

[API](https://skmtc.net/abacatepay/apis/api-abacatepay.md) · [All operations](https://skmtc.net/abacatepay/apis/api-abacatepay/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/abacatepay/api-abacatepay/revisions/6b89a7fa70f5/schema)