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

# Evento customer.updated

> Evento customer.updated.

## Evento `customer.updated`

Disparado quando campos de um cliente mudam — via
[`POST /v1/customers/:id`](/api-reference/customers/update) ou durante o
checkout/cobrança automática (ex.: enriquecimento de `billing_address` ou
`document`).

`data.object` carrega o `customer` completo no estado atual.
`data.previous_attributes` traz só os campos que mudaram, com os valores
**anteriores**.

```json theme={}
{
  "id": "evt_123",
  "object": "event",
  "created_at": "2026-05-16T15:02:10Z",
  "data": {
    "object": {
      "id": "cus_123",
      "object": "customer",
      "billing_address": {
        "city": "São Paulo",
        "country": "BR",
        "line1": "Av. Paulista, 1000",
        "line2": null,
        "postal_code": "01310-100",
        "state": "SP"
      },
      "billing_name": null,
      "created_at": "2026-05-16T14:09:27Z",
      "document": "12345678901",
      "document_type": "cpf",
      "email": "nome@email.com",
      "livemode": true,
      "metadata": {
        "reference_id": "ref_456"
      },
      "name": "Cliente Exemplo",
      "phone": "+5511999990000",
      "updated_at": "2026-05-16T15:02:10Z"
    },
    "previous_attributes": {
      "billing_address": null,
      "phone": null
    }
  },
  "livemode": true,
  "organization": "org_123",
  "request": {
    "id": null
  },
  "type": "customer.updated"
}
```