---
title: "Criar cliente"
method: POST
path: "/v1/customers"
tags: ["Clientes"]
---

# Criar cliente

`POST /v1/customers`

Cria um novo cliente associado a sua organizacao.

## Request body

- CreateCustomerRequest
  - `name` string, required — Nome completo do cliente
  - `email` string, required — E-mail do cliente
  - `externalId` string, nullable — Seu identificador interno
  - `document` string, nullable — CPF ou CNPJ (apenas numeros)
  - `documentType` 'CPF' | 'CNPJ', nullable — Tipo do documento
  - `phone` string, nullable — Telefone com codigo do pais. Aceita com ou sem '+' no envio e e salvo apenas com digitos.
  - `metadata` string, nullable — Metadados em JSON

## Response `201`

Cliente criado com sucesso

- CreateCustomerResponse
  - `data` CustomerData, nullable
    - `id` string, uuid — ID unico do cliente
    - `externalId` string, nullable — ID externo informado
    - `name` string — Nome do cliente
    - `email` string — E-mail do cliente
    - `document` string, nullable — CPF/CNPJ formatado
    - `documentType` 'CPF' | 'CNPJ', nullable — Tipo do documento
    - `phone` string, nullable — Telefone com codigo do pais, salvo apenas com digitos
    - `status` 'Active' | 'Inactive' — Status do cliente
    - `metadata` string, nullable — Metadados
    - `address` CustomerAddress, nullable
      - `street` string, nullable
      - `number` string, nullable
      - `complement` string, nullable
      - `neighborhood` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postalCode` string, nullable
      - `country` string, nullable
    - `createdAt` string, date-time — Data de criacao
  - `message` string, nullable
  - `error` ApiErrorResponse, nullable
    - `message` string — Mensagem de erro
    - `code` string — Codigo do erro

## Other responses

- `400` — Dados invalidos
- `401` — Nao autorizado
- `409` — Cliente ja existe

---

[API](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway.md) · [All operations](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safefy-pay/safefy-pix-gateway/revisions/57157be53ccc/schema)