customer.updated

A customer changed.

On this page

When to use it
Notes
Payload
Example

Type	`customer.updated`
Cause	A field of a customer changed.
Payload	The `customer` object in `data.object`
Subscription	Opt-in. Select it on the endpoint to receive it.

When to use it

Update your copy of the customer.

Notes

data.previous_attributes holds the changed fields with their values before the change.

Payload

The fields of data.object. The envelope is the same for every event.

idstring
The customer ID, cus_….
objectstring
Always customer.
emailstringCan be absentCan be null
The email address.
namestringCan be absentCan be null
The name.
phonestringCan be absentCan be null
The phone number.
countrystringCan be absentCan be null
The ISO 3166-1 alpha-2 country code.
localestringCan be absentCan be null
The preferred language.
metadataobjectCan be absentCan be null
Your own key-value pairs.
created_atstring (date-time)
When the customer was created.
updated_atstring (date-time)
When the customer last changed.

Example

customer.updated · request body

{
  "id": "whevt_7Kd2VpXn4TqB9mLzR",
  "object": "event",
  "type": "customer.updated",
  "created_at": "2026-09-14T09:24:53Z",
  "api_version": "2026-08-01",
  "account_id": "acct_5Rn8bQ2xW7mK4tLzP",
  "data": {
    "object": {
      "id": "cus_2Lp7XcN4vB8mQ1tKd",
      "object": "customer",
      "email": "ada@example.com",
      "name": "Ada Example",
      "phone": null,
      "country": "DE",
      "locale": "de",
      "metadata": {},
      "created_at": "2026-09-01T08:00:00Z",
      "updated_at": "2026-09-14T09:21:07Z"
    }
  }
}

Other customer events: customer.created.

When to use it

Notes

Payload

Example

Related