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

# Payload cliente

> Campo data nos eventos customer.*

Eventos: `customer.created` e `customer.updated`.

`data` é o [Cliente](../customers/reference), com o documento sem máscara:

```json theme={null}
{
  "id": "880e8400-e29b-41d4-a716-446655440000",
  "event": "customer.created",
  "createdAt": "2026-03-18T11:00:00.123Z",
  "data": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "name": "John Customer",
    "email": "john@example.com",
    "document": { "number": "12345678901", "type": "cpf" },
    "phone": { "countryCode": "55", "areaCode": "11", "number": "999998888" },
    "address": {
      "street": "Rua A",
      "number": "100",
      "complement": "Apto 1",
      "neighborhood": "Centro",
      "city": "Sao Paulo",
      "state": "SP",
      "country": "BR",
      "zip": "01001000"
    },
    "createdAt": "2026-03-18T11:00:00.000Z",
    "updatedAt": "2026-03-18T11:00:00.000Z"
  }
}
```

## Campos

| Campo | Tipo | Descrição |
| - | - | - |
| `id` | `string (uuid)` | Cliente |
| `name` | `string` | Nome |
| `email` | `string \| null` | E-mail |
| `document` | `object` | `number` (só dígitos) e `type` (`cpf` ou `cnpj`) |
| `phone` | `object \| null` | `countryCode`, `areaCode`, `number` |
| `address` | `object` | `street`, `number`, `complement`, `neighborhood`, `city`, `state`, `country`, `zip`; cada campo pode ser `null` |
| `createdAt` | `string` | ISO 8601 |
| `updatedAt` | `string` | ISO 8601 |

`customer.created` também dispara quando o cliente é criado inline por uma cobrança. Detalhes: [Referência de clientes](../customers/reference).


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