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

    Inventory

  • List inventory adjustment reasons

  • Create inventory adjustment reason

  • Delete inventory adjustment reason

  • Restore inventory adjustment reason

  • Retrieve inventory adjustment reason

  • Update inventory adjustment reason

  • Update inventory adjustment

  • Retrieve inventory adjustment

  • Batch change inventory

  • Batch retrieve inventory changes

  • Batch retrieve inventory counts

  • Retrieve inventory physical count

  • Retrieve inventory count

  • Webhooks

  • inventory.count.updated

<- Inventory webhooks

Inventory webhooks

All versions ->

inventory count updated

EVENT

 inventory.count.updated

Published when the quantity is updated for a CatalogItemVariation.

Permissions:INVENTORY_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.

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": "6SSW7HV8K2ST5", "type": "inventory.count.updated", "event_id": "df5f3813-a913-45a1-94e9-fdc3f7d5e3b6", "created_at": "2019-10-29T18:38:45.455006797Z", "data": { "type": "inventory_counts", "id": "84e4ac73-d605-4dbd-a9e5-ffff794ddb9d", "object": { "inventory_counts": [ { "calculated_at": "2019-10-29T18:38:45.10296Z", "catalog_object_id": "FGQ5JJWT2PYTHF35CKZ2DSKP", "catalog_object_type": "ITEM_VARIATION", "location_id": "YYQR03DGCTXA4", "quantity": "10", "state": "IN_STOCK" } ] } } }