# \#catalog-api

**URL:** https://developer.squareup.com/forums/tag/catalog-api/10.md

[Latest](https://developer.squareup.com/forums/latest.md) · [Categories](https://developer.squareup.com/forums/categories.md) · [Tags](https://developer.squareup.com/forums/tags.md)

---

## [Square Google Shopping Integration: Incorrect Variation Pricing and Inventory Sync Copy](https://developer.squareup.com/forums/t/square-google-shopping-integration-incorrect-variation-pricing-and-inventory-sync-copy/28232)

<div class="topic-metadata">

**Author:** [@MFranklin](https://developer.squareup.com/forums/u/MFranklin)\
**Replies:** 0\
**Last updated:** [October 15, 2026, 10:53pm UTC](https://developer.squareup.com/forums/t/square-google-shopping-integration-incorrect-variation-pricing-and-inventory-sync-copy/28232 "2026-10-15T22:53:10Z")

</div>

Square Google Shopping Integration: Incorrect Variation Pricing and Inventory Synchronization Hello Square Developer Team, We are experiencing several issues with Square’s built-in Google Shopping integration and would …

---

## [Google Business Profile integration/possible Business category mismatch](https://developer.squareup.com/forums/t/google-business-profile-integration-possible-business-category-mismatch/27985)

<div class="topic-metadata">

**Author:** [@SOSequoyah](https://developer.squareup.com/forums/u/SOSequoyah)\
**Replies:** 3\
**Last updated:** [October 13, 2026, 4:29pm UTC](https://developer.squareup.com/forums/t/google-business-profile-integration-possible-business-category-mismatch/27985 "2026-10-13T16:29:51Z")

</div>

Good day; I am trying to integrate Square with our Google Business Profile, as well as make our items searchable in Google Shopping/Merchant Center. I have made our address, name, and phone number as punctuation perfect …

---

## [Discount API permissions](https://developer.squareup.com/forums/t/discount-api-permissions/28048)

<div class="topic-metadata">

**Author:** [@lewhet25](https://developer.squareup.com/forums/u/lewhet25)\
**Replies:** 3\
**Last updated:** [October 13, 2026, 1:26am UTC](https://developer.squareup.com/forums/t/discount-api-permissions/28048 "2026-10-13T01:26:16Z")

</div>

Hi Square team, We’d like to request access to the Discount Codes API (DISCOUNT\_CODES\_READ and DISCOUNT\_CODES\_WRITE). Use case: we have a private, internal staff app. Managers use it to give customers single-use vouche…

---

## [Square Menu Category Position Retrieval via API](https://developer.squareup.com/forums/t/square-menu-category-position-retrieval-via-api/28157)

<div class="topic-metadata">

**Author:** [@Mahesh](https://developer.squareup.com/forums/u/Mahesh)\
**Replies:** 2\
**Last updated:** [October 12, 2026, 5:58am UTC](https://developer.squareup.com/forums/t/square-menu-category-position-retrieval-via-api/28157 "2026-10-12T05:58:34Z")

</div>

In Square, we have a Menu where the client has arranged the categories in a specific order in the POS. Could you please let us know how we can retrieve the position/order of the categories within the Square Menu through…

---

## [CustomAttributeValues Key issue (C# SDK 45.0.1)](https://developer.squareup.com/forums/t/customattributevalues-key-issue-c-sdk-45-0-1/28130)

<div class="topic-metadata">

**Author:** [@cbstl](https://developer.squareup.com/forums/u/cbstl)\
**Replies:** 4\
**Last updated:** [October 11, 2026, 1:02am UTC](https://developer.squareup.com/forums/t/customattributevalues-key-issue-c-sdk-45-0-1/28130 "2026-10-11T01:02:23Z")

</div>

I’m finally updating my C# web app that uses the Square API from SDK v40.1.0 (just before the significant breaking-changes SDK overhaul) to 45.0.1 and I’m running into an issue with the Key for CustomAttributeValues work…

---

## [DISCOUNT\_CODES\_READ/WRITE OAuth scopes present, but /v2/discount-codes returns NOT\_FOUND](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250)

<div class="topic-metadata">

**Author:** [@twoflatlabs](https://developer.squareup.com/forums/u/twoflatlabs)\
**Replies:** 10\
**Last updated:** [October 6, 2026, 1:06pm UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250 "2026-10-06T13:06:42Z")

</div>

I’m building a Square OAuth integration and am trying to determine whether the Discount Codes API is available to third-party applications. I’ve discovered that the Square Dashboard is actively using the following endpo…

---

## [Request for Discount Codes API](https://developer.squareup.com/forums/t/request-for-discount-codes-api/28092)

<div class="topic-metadata">

**Author:** [@dbz](https://developer.squareup.com/forums/u/dbz)\
**Replies:** 2\
**Last updated:** [October 5, 2026, 8:49pm UTC](https://developer.squareup.com/forums/t/request-for-discount-codes-api/28092 "2026-10-05T20:49:54Z")

</div>

Hi Square Developer team, We’d like to request access to the Discount Codes API for our production Square application. GetSetReply helps local restaurants bring customers back with coupons. Merchants connect their Squa…

---

## [Please expose item prep times through the API](https://developer.squareup.com/forums/t/please-expose-item-prep-times-through-the-api/27936)

<div class="topic-metadata">

**Author:** [@bobisback](https://developer.squareup.com/forums/u/bobisback)\
**Replies:** 3\
**Last updated:** [September 25, 2026, 4:44pm UTC](https://developer.squareup.com/forums/t/please-expose-item-prep-times-through-the-api/27936 "2026-09-25T16:44:55Z")

</div>

Hi, I’m building kiosk and customer-ordering apps that create pickup orders through Square’s Orders API. Square Online calculates an order’s prep time using the longest prep time among the items in the cart. The result…

---

## [Catalog API returning 9 discounts while Dashboard shows only 2](https://developer.squareup.com/forums/t/catalog-api-returning-9-discounts-while-dashboard-shows-only-2/27962)

<div class="topic-metadata">

**Author:** [@Geetanjali](https://developer.squareup.com/forums/u/Geetanjali)\
**Replies:** 1\
**Last updated:** [September 23, 2026, 11:27pm UTC](https://developer.squareup.com/forums/t/catalog-api-returning-9-discounts-while-dashboard-shows-only-2/27962 "2026-09-23T23:27:13Z")

</div>

Hi Square team, We are seeing a discrepancy between the Square Dashboard and the Catalog API when retrieving DISCOUNT objects. On the \*Square Dashboard, we can currently see only 2 discounts. However, when we retrieve …

---

## [All MODIFIER\_LIST objects deleted automatically minutes to hours after creation - 9 occurrences, both Dashboard and Catalog API](https://developer.squareup.com/forums/t/all-modifier-list-objects-deleted-automatically-minutes-to-hours-after-creation-9-occurrences-both-dashboard-and-catalog-api/27961)

<div class="topic-metadata">

**Author:** [@twcrobson](https://developer.squareup.com/forums/u/twcrobson)\
**Replies:** 1\
**Last updated:** [September 23, 2026, 9:57pm UTC](https://developer.squareup.com/forums/t/all-modifier-list-objects-deleted-automatically-minutes-to-hours-after-creation-9-occurrences-both-dashboard-and-catalog-api/27961 "2026-09-23T21:57:32Z")

</div>

Every modifier list I create in my catalog is deleted automatically, without any action from me. This has happened nine times since August 22 across two different creation methods. I currently have zero modifier lists an…

---

## [Request for Discount Codes API Special Access — urMuv Rewards](https://developer.squareup.com/forums/t/request-for-discount-codes-api-special-access-urmuv-rewards/27925)

<div class="topic-metadata">

**Author:** [@Urmuv](https://developer.squareup.com/forums/u/Urmuv)\
**Replies:** 1\
**Last updated:** [September 23, 2026, 1:45pm UTC](https://developer.squareup.com/forums/t/request-for-discount-codes-api-special-access-urmuv-rewards/27925 "2026-09-23T13:45:57Z")

</div>

Hi Square Developer Team, We would like to request special access to the Discount Codes API for urMuv Rewards, including DISCOUNT\_CODES\_READ and DISCOUNT\_CODES\_WRITE, beginning with Sandbox testing. urMuv is a merchant…

---

## [Catalog items created via API never appear in the Dashboard item library list (visible in POS app and Dashboard search)](https://developer.squareup.com/forums/t/catalog-items-created-via-api-never-appear-in-the-dashboard-item-library-list-visible-in-pos-app-and-dashboard-search/27516)

<div class="topic-metadata">

**Author:** [@MND](https://developer.squareup.com/forums/u/MND)\
**Replies:** 6\
**Last updated:** [September 19, 2026, 7:25pm UTC](https://developer.squareup.com/forums/t/catalog-items-created-via-api-never-appear-in-the-dashboard-item-library-list-visible-in-pos-app-and-dashboard-search/27516 "2026-09-19T19:25:47Z")

</div>

Hi, I’m running a self-hosted inventory system (FastAPI + SQLite) that syncs products to Square via the Catalog API. I’m seeing two issues I can’t explain, and I’d appreciate any insight. Environment Square API versi…

---

## [Modifier Channel Visibility](https://developer.squareup.com/forums/t/modifier-channel-visibility/27608)

<div class="topic-metadata">

**Author:** [@LMK](https://developer.squareup.com/forums/u/LMK)\
**Replies:** 1\
**Last updated:** [September 14, 2026, 7:30pm UTC](https://developer.squareup.com/forums/t/modifier-channel-visibility/27608 "2026-09-14T19:30:54Z")

</div>

Is there any way to retrieve modifier list channel visibility (Point of Sale vs Online) via the Catalog API? The Dashboard shows which channels each modifier list is enabled for, but I can’t find this field in the /v2/ca…

---

## [Nested modifiers now available in the Catalog API](https://developer.squareup.com/forums/t/nested-modifiers-now-available-in-the-catalog-api/27439)

<div class="topic-metadata">

**Author:** [@ashley-square](https://developer.squareup.com/forums/u/ashley-square)\
**Replies:** 2\
**Last updated:** [September 8, 2026, 5:03pm UTC](https://developer.squareup.com/forums/t/nested-modifiers-now-available-in-the-catalog-api/27439 "2026-09-08T17:03:41Z")

</div>

Hi everyone, We’re happy to share that nested modifier support in the Catalog API shipped as part of the 2026-08-19 API release. What’s changed: Nested modifiers are now available in the public API. Previously, access…

---

## [Modifier lists deleted automatically minutes to hours after creation (9+ Occurences)](https://developer.squareup.com/forums/t/modifier-lists-deleted-automatically-minutes-to-hours-after-creation-9-occurences/27462)

<div class="topic-metadata">

**Author:** [@cafeOwner](https://developer.squareup.com/forums/u/cafeOwner)\
**Replies:** 5\
**Last updated:** [September 4, 2026, 3:24pm UTC](https://developer.squareup.com/forums/t/modifier-lists-deleted-automatically-minutes-to-hours-after-creation-9-occurences/27462 "2026-09-04T15:24:38Z")

</div>

Every modifier list in my Square catalog gets deleted automatically, anywhere from a few minutes to a few hours after I create it. It has happened at least nine times since August 22. I run a cafe and right now I have to…

---

## [Early access request — nested modifiers via Catalog API](https://developer.squareup.com/forums/t/early-access-request-nested-modifiers-via-catalog-api/27247)

<div class="topic-metadata">

**Author:** [@Fernside](https://developer.squareup.com/forums/u/Fernside)\
**Replies:** 5\
**Last updated:** [September 1, 2026, 7:28pm UTC](https://developer.squareup.com/forums/t/early-access-request-nested-modifiers-via-catalog-api/27247 "2026-09-01T19:28:44Z")

</div>

Following up on the nested modifiers beta discussion from 5 August. We run a cafe on Square for Restaurants (Full service) and are building a customer ordering app against the Catalog and Orders APIs. We have the nested…

---

## [Requesting Access to Discount Codes API](https://developer.squareup.com/forums/t/requesting-access-to-discount-codes-api/27395)

<div class="topic-metadata">

**Author:** [@PracticallyPotion](https://developer.squareup.com/forums/u/PracticallyPotion)\
**Replies:** 2\
**Last updated:** [September 1, 2026, 9:18am UTC](https://developer.squareup.com/forums/t/requesting-access-to-discount-codes-api/27395 "2026-09-01T09:18:29Z")

</div>

Hello, I’d like to request access to the Discount Codes API for a private integration I’m building for my own Square store. My use case is automatically generating unique, single-use Square Online coupon codes when view…

---

## [Default quantity on a modifier](https://developer.squareup.com/forums/t/default-quantity-on-a-modifier/27206)

<div class="topic-metadata">

**Author:** [@arian.asghari95](https://developer.squareup.com/forums/u/arian.asghari95)\
**Replies:** 4\
**Last updated:** [August 17, 2026, 5:33pm UTC](https://developer.squareup.com/forums/t/default-quantity-on-a-modifier/27206 "2026-08-17T17:33:39Z")

</div>

In modifiers with allow\_quantity set to true, how do I get the default quantity? A use case would be for example a vanilla latte has 2 pumps of vanilla syrup by default, and I would like to display the item with 2 pumps …

---

## [429 "Catalog locked by prior request" on first BatchUpsertCatalogObjects request in production](https://developer.squareup.com/forums/t/429-catalog-locked-by-prior-request-on-first-batchupsertcatalogobjects-request-in-production/27152)

<div class="topic-metadata">

**Author:** [@DevNateev](https://developer.squareup.com/forums/u/DevNateev)\
**Replies:** 5\
**Last updated:** [August 17, 2026, 4:51pm UTC](https://developer.squareup.com/forums/t/429-catalog-locked-by-prior-request-on-first-batchupsertcatalogobjects-request-in-production/27152 "2026-08-17T16:51:38Z")

</div>

We are currently implementing a full catalog synchronization between our e-commerce platform and Square for one of our clients. We are using the Catalog API and BatchUpsertCatalogObjects to synchronize products from the…

---

## [Cannot find how to create Classes programmatically](https://developer.squareup.com/forums/t/cannot-find-how-to-create-classes-programmatically/25891)

<div class="topic-metadata">

**Author:** [@devinnasar](https://developer.squareup.com/forums/u/devinnasar)\
**Replies:** 5\
**Last updated:** [August 13, 2026, 3:02pm UTC](https://developer.squareup.com/forums/t/cannot-find-how-to-create-classes-programmatically/25891 "2026-08-13T15:02:12Z")

</div>

Hello, I’m trying to understand how to create Classes programmatically. I can see certain aspects of the Classes I’ve created in the UI in the bookings API, but I can’t find anything related to scheduling or to staff as…

---

## [Sandbox item modifier removed but still showing in retrieve catalog object endpoint](https://developer.squareup.com/forums/t/sandbox-item-modifier-removed-but-still-showing-in-retrieve-catalog-object-endpoint/27179)

<div class="topic-metadata">

**Author:** [@arian.asghari95](https://developer.squareup.com/forums/u/arian.asghari95)\
**Replies:** 1\
**Last updated:** [August 13, 2026, 2:46pm UTC](https://developer.squareup.com/forums/t/sandbox-item-modifier-removed-but-still-showing-in-retrieve-catalog-object-endpoint/27179 "2026-08-13T14:46:22Z")

</div>

I am retrieving the catalog object "id": "TQBHKAOD3L2IMGVA6677JWAJ" and I only have assigned the modifier list "modifier\_list\_id": "QGTJYGJRATNSSIFOV5VLKH6B" which is a text-based modifier to it on the dashboard but I am…

---

## [Setting In/Out of Stock](https://developer.squareup.com/forums/t/setting-in-out-of-stock/22649)

<div class="topic-metadata">

**Author:** [@jdevelvis](https://developer.squareup.com/forums/u/jdevelvis)\
**Replies:** 6\
**Last updated:** [August 13, 2026, 10:39am UTC](https://developer.squareup.com/forums/t/setting-in-out-of-stock/22649 "2026-08-13T10:39:45Z")

</div>

Is there a way to set an item in/out of stock via the API without changing the inventory number in Square for it to 0? My app tracks inventory separately from Square, and I don’t want to have to sync inventory numbers in…

---

## [Min and max selection modifier confusion](https://developer.squareup.com/forums/t/min-and-max-selection-modifier-confusion/27158)

<div class="topic-metadata">

**Author:** [@arian.asghari95](https://developer.squareup.com/forums/u/arian.asghari95)\
**Replies:** 7\
**Last updated:** [August 12, 2026, 9:06pm UTC](https://developer.squareup.com/forums/t/min-and-max-selection-modifier-confusion/27158 "2026-08-12T21:06:21Z")

</div>

I am trying to render the seller catalog as a radio button or checkbox and I have some confusion when it comes to min\_selected\_modifiers, max\_selected\_modifiers, and selection\_type: Firstly, selection\_type is labeled a…

---

## [Custom\_attribute\_values on an ITEM silently don't persist (sandbox) — reproduced without the SDK](https://developer.squareup.com/forums/t/custom-attribute-values-on-an-item-silently-dont-persist-sandbox-reproduced-without-the-sdk/27162)

<div class="topic-metadata">

**Author:** [@UKM.sr](https://developer.squareup.com/forums/u/UKM.sr)\
**Replies:** 1\
**Last updated:** [August 12, 2026, 3:59pm UTC](https://developer.squareup.com/forums/t/custom-attribute-values-on-an-item-silently-dont-persist-sandbox-reproduced-without-the-sdk/27162 "2026-08-12T15:59:24Z")

</div>

I’m building a Catalog API integration against a sandbox test account and can’t get custom\_attribute\_values to persist on an ITEM object. The write reports success (200, no errors array) but the value is never present on…

---

## [Is the Nested Modifiers beta supported by Square APIs?](https://developer.squareup.com/forums/t/is-the-nested-modifiers-beta-supported-by-square-apis/27107)

<div class="topic-metadata">

**Author:** [@shipday](https://developer.squareup.com/forums/u/shipday)\
**Replies:** 3\
**Last updated:** [August 10, 2026, 4:14pm UTC](https://developer.squareup.com/forums/t/is-the-nested-modifiers-beta-supported-by-square-apis/27107 "2026-08-10T16:14:03Z")

</div>

Hi Square Developer Community, Square has a beta feature for Nested Modifiers, where selecting one modifier can reveal another modifier set. I reviewed the current API documentation, including CatalogModifier, CatalogM…

---

## [Do inventory updates over api affect COGS?](https://developer.squareup.com/forums/t/do-inventory-updates-over-api-affect-cogs/24432)

<div class="topic-metadata">

**Author:** [@drayle](https://developer.squareup.com/forums/u/drayle)\
**Replies:** 7\
**Last updated:** [July 30, 2026, 12:10am UTC](https://developer.squareup.com/forums/t/do-inventory-updates-over-api-affect-cogs/24432 "2026-07-30T00:10:40Z")

</div>

I’ve been researching the api docs, and am seeing a concerning trend: none of the calls between catalog api and inventory api seem to mention fields that relate to Cost of Goods Sold (vendor, unit cost, etc.). I haven’t …

---

## [Cost of Goods Sold](https://developer.squareup.com/forums/t/cost-of-goods-sold/246)

<div class="topic-metadata">

**Author:** [@franklyn-faire](https://developer.squareup.com/forums/u/franklyn-faire)\
**Replies:** 56\
**Last updated:** [July 30, 2026, 12:08am UTC](https://developer.squareup.com/forums/t/cost-of-goods-sold/246 "2026-07-30T00:08:42Z")

</div>

As I currently understand, Cost of Goods Sold (unit cost) is available for retailers who pay for Square for Retail (with Inventory Plus features). Is this data accessible in the API? if so, is it returned from the catalo…

---

## [Catalog.version.updated and inventory.count.updated never generated — location and customer events work fine on the same subscription](https://developer.squareup.com/forums/t/catalog-version-updated-and-inventory-count-updated-never-generated-location-and-customer-events-work-fine-on-the-same-subscription/26822)

<div class="topic-metadata">

**Author:** [@globalgrowers](https://developer.squareup.com/forums/u/globalgrowers)\
**Replies:** 0\
**Last updated:** [July 10, 2026, 6:22pm UTC](https://developer.squareup.com/forums/t/catalog-version-updated-and-inventory-count-updated-never-generated-location-and-customer-events-work-fine-on-the-same-subscription/26822 "2026-07-10T18:22:00Z")

</div>

Application ID: sq0idp-aY-hLFD5UqQGQHaYNrMLLw I have a Production webhook subscription on an application owned by the same Square account that owns the merchant (owner role). The subscription is Enabled, points at an HT…

---

## [Shipping Weight via API or Other Automation](https://developer.squareup.com/forums/t/shipping-weight-via-api-or-other-automation/26598)

<div class="topic-metadata">

**Author:** [@cronescupboard](https://developer.squareup.com/forums/u/cronescupboard)\
**Replies:** 1\
**Last updated:** [July 7, 2026, 4:40pm UTC](https://developer.squareup.com/forums/t/shipping-weight-via-api-or-other-automation/26598 "2026-07-07T16:40:10Z")

</div>

Shipping weight has been baked into items for years now, but it looks like there’s still no way to touch it with the API. ToS seems to indicate that using Playwright or something similar to accomplish the feat is forbidd…

---

## [Request for API Rate Limit Review / Increase](https://developer.squareup.com/forums/t/request-for-api-rate-limit-review-increase/26353)

<div class="topic-metadata">

**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\
**Replies:** 4\
**Last updated:** [June 11, 2026, 7:08pm UTC](https://developer.squareup.com/forums/t/request-for-api-rate-limit-review-increase/26353 "2026-06-11T19:08:37Z")

</div>

Hello Square Team, We would like to discuss the API rate limits for our integration and seek your guidance on possible solutions. Our Business Scenario We support a merchant organization that currently operates more th…

[Next page](https://developer.squareup.com/forums/tag/catalog-api/10.md?match_all_tags=true&page=1&tags%5B%5D=catalog-api)
