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

    Loyalty

  • Create loyalty account

  • Search loyalty accounts

  • Retrieve loyalty account

  • Accumulate loyalty points

  • Adjust loyalty points

  • Search loyalty events

  • Retrieve loyalty program

  • Calculate loyalty points

  • List loyalty promotions

  • Create loyalty promotion

  • Retrieve loyalty promotion

  • Cancel loyalty promotion

  • Create loyalty reward

  • Search loyalty rewards

  • Delete loyalty reward

  • Retrieve loyalty reward

  • Redeem loyalty reward

  • Webhooks

  • loyalty.account.created

  • loyalty.account.deleted

  • loyalty.account.updated

  • loyalty.event.created

  • loyalty.program.created

  • loyalty.program.updated

  • loyalty.promotion.created

  • loyalty.promotion.updated

<- Loyalty webhooks

Loyalty webhooks

All versions ->

loyalty account updated

EVENT

 loyalty.account.updated

Published when a loyalty account is updated.

Permissions:LOYALTY_READ
Link to section

Event payload

Example code

Link to section

merchant_id

string

The ID of the Square seller associated with the event.

Link to section

type

string

The type of event. For this event, the value is loyalty.account.updated.

Link to section

event_id

string

The unique ID for the event, which is used for idempotency support.

Link to section

created_at

string

Read only The timestamp of when the event 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.

Link to section

Examples

All versions ->

Response JSON

{ "merchant_id": "C337NFWQT2A6W", "type": "loyalty.account.updated", "event_id": "3ca83966-230e-4a61-8484-22ea749ea765", "created_at": "2020-05-13T01:46:58.794Z", "data": { "type": "loyalty_account", "id": "ba2f8ab6-e131-46d9-9882-17714404eb49", "object": { "loyalty_account": { "id": "ba2f8ab6-e131-46d9-9882-17714404eb49", "program_id": "5216e8b2-d43e-41e2-9ed8-eccf3e892aef", "balance": 10, "lifetime_points": 10, "mapping": { "created_at": "2020-05-13T01:41:34Z", "id": "664c22ba-9460-45a5-8917-381ae72dcfdc", "phone_number": "+14155551234" }, "customer_id": "QPTXM8PQNX3Q726ZYHPMNP46XC", "enrolled_at": "2020-05-13T01:41:34Z", "created_at": "2020-05-13T01:41:34Z", "updated_at": "2020-05-13T01:41:34Z" } } } }