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

    Subscriptions

  • Create subscription

  • Bulk swap plan

  • Search subscriptions

  • Retrieve subscription

  • Update subscription

  • Delete subscription action

  • Change billing anchor date

  • Cancel subscription

  • List subscription events

  • Pause subscription

  • Resume subscription

  • Swap plan

  • Webhooks

  • subscription.created

  • subscription.updated

<- Subscriptions webhooks

Subscriptions webhooks

All versions ->

subscription updated

EVENT

 subscription.updated

Published when a Subscription is updated. Typically the subscription.status is updated as subscriptions become active or cancelled.

Permissions:SUBSCRIPTIONS_READ
Link to section

Event payload

Example code

Link to section

merchant_id

string

The ID of the target merchant associated with the event.

Link to section

type

string

The type of event this represents, "subscription.updated".

Link to section

event_id

string

A unique ID for the event.

Link to section

created_at

string

Read only 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

Data associated with the event.

Link to section

Examples

All versions ->

Response JSON

{ "merchant_id": "VSE65BA53PXCC", "type": "subscription.updated", "event_id": "c0b40cc0-7cb2-4aa1-81ce-0893b9b0b9b8", "created_at": "2020-07-15T05:14:11.213Z", "data": { "type": "subscription", "id": "592b9720-d2ef-4ee4-b3fd-9d98e4f829d2", "object": { "subscription": { "id": "592b9720-d2ef-4ee4-b3fd-9d98e4f829d2", "created_date": "2020-07-15", "customer_id": "QX2XG9GMQS2BVBJKPG8CJ8JKCR", "location_id": "EZHGJ7SNVAJ19", "plan_variation_id": "CRUUZUK5W6PIIM6H54242NV6", "start_date": "2020-07-15", "status": "ACTIVE", "tax_percentage": "5", "timezone": "America/New_York", "version": 1594790050754 } } } }