Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

    Webhooks

  • customer.custom_attribute_definition.created

  • customer.custom_attribute_definition.public.created

  • customer.custom_attribute_definition.deleted

  • customer.custom_attribute_definition.public.deleted

  • customer.custom_attribute_definition.updated

  • customer.custom_attribute_definition.public.updated

  • customer.custom_attribute.deleted

  • customer.custom_attribute.public.deleted

  • customer.custom_attribute.updated

  • customer.custom_attribute.public.updated

<- Customer Custom Attributes webhooks

Customer Custom Attributes webhooks

All versions ->

customer custom_attribute updated

DEPRECATED

 customer.custom_attribute.updated

Published when a customer custom attribute owned by the subscribing application is created or updated. Custom attributes are owned by the application that created the corresponding custom attribute definition. Custom attributes whose visibility is VISIBILITY_READ_WRITE_VALUES can be created or updated by any application.

This event is replaced by customer.custom_attribute.owned.updated.

Permissions:CUSTOMERS_READ
Link to section

Event payload

Example code

Link to section

merchant_id

string

The ID of the seller associated with the event that triggered the event notification.

Link to section

type

string

The type of this event. The value is "customer.custom_attribute.updated".

Link to section

event_id

string

A unique ID for the event notification.

Link to section

created_at

string

Read only The timestamp that indicates when the event notification was created, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Link to section

data

The data associated with the event that triggered the event notification.

Link to section

Examples

All versions ->

Response JSON

{ "merchant_id": "DM7VKY8Q63GNP", "type": "customer.custom_attribute.updated", "event_id": "e26ca6f2-97f8-426a-b4bf-873044617e94", "created_at": "2022-04-21T21:40:54Z", "data": { "type": "custom_attribute", "id": "sq0idp-LJ1Kr4Iim0hGDvAwrv8HIB:favorite-drink:CUSTOMER:TNQC0TYTWMRSFFQ157KK4V7MVR", "object": { "created_at": "2022-04-21T21:40:54Z", "key": "sq0idp-LJ1Kr4Iim0hGDvAwrv8HIB:favorite-drink", "updated_at": "2022-04-21T21:40:54Z", "value": "Double-shot breve", "version": 1, "visibility": "VISIBILITY_READ_ONLY" } } }