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

    Customer Custom Attributes

  • List customer custom attribute definitions

  • Create customer custom attribute definition

  • Delete customer custom attribute definition

  • Retrieve customer custom attribute definition

  • Update customer custom attribute definition

  • Bulk upsert customer custom attributes

  • List customer custom attributes

  • Delete customer custom attribute

  • Retrieve customer custom attribute

  • Upsert customer custom attribute

  • Webhooks

  • customer.custom_attribute_definition.owned.created

  • customer.custom_attribute_definition.owned.deleted

  • customer.custom_attribute_definition.owned.updated

  • customer.custom_attribute_definition.visible.created

  • customer.custom_attribute_definition.visible.deleted

  • customer.custom_attribute_definition.visible.updated

  • customer.custom_attribute.owned.deleted

  • customer.custom_attribute.owned.updated

  • customer.custom_attribute.visible.deleted

  • customer.custom_attribute.visible.updated

<- Customer Custom Attributes webhooks

Customer Custom Attributes webhooks

All versions ->

customer custom_attribute owned updated

EVENT

 customer.custom_attribute.owned.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.

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.owned.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.owned.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" } } }