---
title: "Create or update a customer | Criar ou atualizar cliente"
method: POST
path: "/customers"
tags: ["Customers | Clientes"]
---

# Create or update a customer | Criar ou atualizar cliente

`POST /customers`

Processes KYC data to create a new customer or update an existing one. | Processa dados KYC para criar um novo cliente ou atualizar um existente.

## Request body

- DevAzureComFitbankOSBECDOScdInternalDomainCustomerRequest
  - `document` string, required — CPF (11 or 14 without punctuation) or CNPJ (14 or 18 with punctuation)
  - `email` string
  - `full_name` string, required
  - `origin_date` string, required — Expecting YYYY-MM-DD
  - `phone` string — E.g., 11999998888 or (11) 99999-8888
  - `type` 'PF' | 'PJ', required
  - `zip_code` string — E.g., 12345-678 or 12345678

## Response `200`

Customer updated successfully | Cliente atualizado com sucesso

- DocsExampleCreateOrUpdateCustomer
  - `code` string
  - `data` DocsCustomerResponseSimplified
    - `created_at` string
    - `document` string
    - `email` string
    - `full_name` string
    - `id` string
    - `origin_date` string
    - `phone` string
    - `type` string
    - `updated_at` string
    - `zip_code` string
  - `message` string
  - `request_id` string

## Other responses

- `201` — Customer created successfully | Cliente criado com sucesso
- `400` — Invalid request payload or validation error | Dados de requisição inválidos ou erro de validação
- `500` — Internal server error | Erro interno do servidor

---

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