For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GuidesAPI Reference
GuidesAPI Reference
  • Network API
      • GETList customers
      • GETRetrieve customer
      • GETRetrieve customer grant
      • GETList customer grants
      • POSTRevoke customer grant
      • Customer
      • POSTEvent: grant.created
      • POSTEvent: grant.status.updated
      • POSTEvent: customer.created
      • POSTEvent: customer.updated
      • POSTEvent: customer.deleted
  • Customer Request API
  • Management API
LogoLogo
Network APICustomers

Event: customer.updated

Payload
1{
2  "type": "customer.updated",
3  "event_id": "WE_8yi33949zgj5cerqmpuwuqfgw",
4  "created_at": "2019-08-24T14:15:22Z",
5  "data": {
6    "id": "CST_AQmxh4y_QGoNNIG5NUw0jttqyYedL1LklACQdyJ3H-Vs6WmLtP6A_C7XjQNohvY",
7    "object": {
8      "customer": {
9        "id": "CST_AQmxh4y_QGoNNIG5NUw0jttqyYedL1LklACQdyJ3H-Vs6WmLtP6A_C7XjQNohvY",
10        "cashtag": "$janedoe"
11      }
12    },
13    "type": "customer"
14  }
15}
**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.
Was this page helpful?
Previous

Event: customer.deleted

Next
Built with

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.

Payload

The payload of this webhook request is an object.
typestringRequired

The type of event that occurred. customer.updated for this event.

event_idstringRequired
A unique identifier provided by Cash App for the event.
created_atstringRequiredformat: "date-time"

When this event occured in RFC 3339 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.

dataobjectRequired
Data about the Customer that was updated.

Response

200
any
Return a 200 status to indicate that the data was received successfully.