square-catalog

Use when working with Square Catalog API for item management, categories, modifiers, images, or pricing. Also use when working with Square Inventory API for stock tracking, batch adjustments, or inventory counts.

Model	Source
sonnet	pack: payments

Full Reference

┏━ 🔧 square-catalog ━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Use when working with Square Catalog API for i… ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Square Catalog & Inventory

API Version: 2026-01-22 | SDK: square v44.x (Node.js) / squareup v44.x (Python)

Quick Reference

Item	Value
Auth	SQUARE_ACCESS_TOKEN env var → Authorization: Bearer <token>
Permissions	ITEMS_READ/WRITE, INVENTORY_READ/WRITE
Amounts	Integers (cents); Node.js requires BigInt
Updates	Full object required — sparse updates reset omitted fields
New (2026-01-22)	buyer_facing_name, kitchen_name (beta) on items + variations

Reference — Load by Task

I want to…	File
SDK setup, auth, sandbox	reference/setup-and-auth.md
Object types, field schemas	reference/object-hierarchy.md
Create, update, delete, batch ops	reference/crud-and-batch.md
Search, list, filter	reference/search.md
Images, modifiers, taxes, discounts	reference/images-modifiers-taxes.md
Inventory counts, adjustments, transfers	reference/inventory.md
KDS fields, Orders/Bookings/Online integration	reference/kds-and-integrations.md
Error codes, rate limits	reference/errors-and-limits.md

Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.