> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wyzecash.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar cliente

> Cadastra quem paga você, para ligar cobranças a ele.

Escopo `customers:write`. E-mail, celular e documento ficam criptografados na WyzeCash.

**name** `string` *required*

2 a 120 caracteres (`INVALID_NAME`).

**email** `string | null`

E-mail válido (`INVALID_EMAIL`).

**phone** `string | null`

Celular com DDD, com ou sem +55, formatado ou só dígitos (`INVALID_PHONE`).

**document** `string | null`

CPF ou CNPJ válido, com ou sem pontuação (`INVALID_DOCUMENT`).

## Resposta

**id** `string`

UUID do cliente. Use em `customerId` ao criar cobranças.

**name** `string`

Nome.

**email** `string | null`

E-mail.

**phone** `string | null`

Celular, só dígitos.

**document** `string | null`

CPF ou CNPJ, só dígitos.

**createdAt** `string`

Criação.

```bash cURL theme={null}
curl -X POST https://api.wyzecash.com.br/v1/customers \
  -H "Authorization: Bearer bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ana Souza", "email": "ana@exemplo.com", "phone": "11999998888", "document": "123.456.789-09" }'
```

```json 200 theme={null}
{
  "id": "0d6c1a7e-5b7f-4f3e-9b2a-1c2d3e4f5a6b",
  "name": "Ana Souza",
  "email": "ana@exemplo.com",
  "phone": "11999998888",
  "document": "12345678909",
  "createdAt": "2026-10-08T15:00:00.000Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.