> This page is for Cash App Pay Partner API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.cash.app/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.cash.app/_mcp/server.

# Event: customer.updated

POST 

**When is this event triggered?**

This event is created whenever a Cash App Pay customer is updated. The `customer.updated` event can be triggered when:
  - A customer updates their Cashtag.
  - A customer approves a request with a `customer_metadata.reference_id` attribute. Upon approval of the request, the customer's `reference_id` attribute is updated.

  > **Note:** If the `customer_metadata.reference_id` is the same as the customer's current `reference_id`, the customer will not be updated and the event will not be triggered.

Reference: https://developers.cash.app/cash-app-pay-partner-api/api-reference/network-api/customer-updated

## Request

### Payload

- `type` (string, required) — The type of event that occurred. `customer.updated` for this event.
- `event_id` (string, required) — A unique identifier provided by Cash App for the event.
- `created_at` (datetime, required) — When this event occured in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC). The time that the event is delivered may be significantly later than this timestamp due to webhooks being retried for up to 72 hours.
- `data` (CustomerUpdatedPayloadData, required) — Data about the Customer that was updated.

## Types

### CustomerUpdatedPayloadData

Data about the Customer that was updated.

- `id` (string, required) — A unique identifier provided by Cash App for the customer.
- `object` (CustomerUpdatedPayloadDataObject, required) — A snapshot of the customer immediately after the customer was updated.
- `type` (string, required) — The resource type contained in the `object` field. For this event, it is `customer`.

### CustomerUpdatedPayloadDataObject

A snapshot of the customer immediately after the customer was updated.

- `customer` (Customer, required)

### Customer

- `id` (string, required) — Unique identifier for this customer issued by Cash App. Min length: `1` Max length: `128`
- `cashtag` (string, required) — Public identifier for the customer on Cash App. [Learn more](https://cash.app/help/us/en-us/3123-cashtags). Min length: `1` Max length: `1024`
- `reference_id` (string, optional) — A user-defined identifier for this customer, typically used to associate the customer with a record in an external system. This value can be provided via the `CustomerRequest.customer_metadata.reference_id` attribute. Upon approval of the CustomerRequest, a corresponding customer resource is created with the `reference_id` attribute.