# DISCOUNT\_CODES\_READ/WRITE OAuth scopes present, but /v2/discount-codes returns NOT\_FOUND **URL:** \ **Category:** Questions\ **Tags:** catalog-api, oauth-api\ **Created:** [August 18, 2026, 11:09pm UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250 "2026-08-18T23:09:06Z")\ **Posts on this page:** 13\ **Page:** 1
**Author:** ![twoflatlabs](https://avatars.discourse-cdn.com/v4/letter/t/9de0a6/32.png) [@twoflatlabs](https://developer.squareup.com/forums/u/twoflatlabs)\ **Post date:** [August 18, 2026, 11:09pm UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/1 "2026-08-18T23:09:06Z")
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 endpoints: ```javascript POST /v2/discount-codes/search POST /v2/discount-codes GET /v2/discount-codes/{discount_code_id}/qr-codes ``` The Dashboard is able to create and retrieve discount codes through these endpoints. For example, creating a code produces an object like: ```javascript { "discount_code": { "id": "555555-67e3-4b66-b79a-1eb0fd9b4734", "code": "INTERNAL", "pricing_rule_id": "IQN84nfKJS94", "max_redemptions": -1, "reason": "COUPON_BUILDER", "pricing_rule_version": 1787031257029, "max_redemptions_per_customer": 1 } } ``` The QR endpoint also returns a Square coupon QR identifier: ```javascript { "qr_code": { "id": "sqcw:8fhefh9ufh9urhf2", "content_type": "IMAGE_PNG" } } ``` My OAuth access token has the following scopes: ```javascript DISCOUNT_CODES_READ DISCOUNT_CODES_WRITE ``` However, when I make the same requests through the public Connect API using the OAuth access token, I receive: ```javascript { "errors": [{ "category": "INVALID_REQUEST_ERROR", "code": "NOT_FOUND", "detail": "API endpoint for URL path `/v2/discount-codes` and HTTP method `CreateDiscountCode` is not found." }] } ``` I’ve tested multiple current and older Square API versions, and the result is the same. Interestingly, the Square Dashboard’s authenticated session can successfully call the endpoint. I can also see the Dashboard making the request directly in the browser’s network inspector. **My question is:** Are `DISCOUNT_CODES_READ` and `DISCOUNT_CODES_WRITE` restricted to particular Square applications, programs, or merchant/app entitlements? If so, what is required for a third-party OAuth application to obtain access to these endpoints? I’m specifically trying to determine whether this is: 1. an OAuth scope issue 2. an application/partner entitlement 3. a merchant eligibility restriction Unblocking this would enable my merchant to have an omni-channel solution for discount codes and could increase in-store returns. I would appreciate any clarification from the Square developer/API team. ---
**Author:** ![jseok](https://avatars.discourse-cdn.com/v4/letter/j/f475e1/32.png) [@jseok](https://developer.squareup.com/forums/u/jseok)\ **Post date:** [August 20, 2026, 12:57am UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/4 "2026-08-20T00:57:18Z")
Hi @twoflatlabs - access to the Discount Codes API is available through special request - I’ve started the process on our side and will follow up with more details via DM. ---
**Author:** ![twoflatlabs](https://avatars.discourse-cdn.com/v4/letter/t/9de0a6/32.png) [@twoflatlabs](https://developer.squareup.com/forums/u/twoflatlabs)\ **Post date:** [August 20, 2026, 2:35am UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/5 "2026-08-20T02:35:03Z")
That’s great news, looking forward to hearing from you. Thanks so much! ---
**Author:** ![pehughes](https://avatars.discourse-cdn.com/v4/letter/p/bb73d2/32.png) [@pehughes](https://developer.squareup.com/forums/u/pehughes)\ **Post date:** [August 27, 2026, 7:54am UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/7 "2026-08-27T07:54:33Z")
Hi Square Developer team, We’re developing a Square integration and would like to request access to the Discount Codes API, including DISCOUNT\_CODES\_READ and DISCOUNT\_CODES\_WRITE. We’ve seen previous forum posts indicating that access to /v2/discount-codes may be available by special request. Could someone from the Square team please assist with the process for requesting access for our application? Happy to provide our application ID and further details about our use case privately. Thanks. ---
**Author:** ![jseok](https://avatars.discourse-cdn.com/v4/letter/j/f475e1/32.png) [@jseok](https://developer.squareup.com/forums/u/jseok)\ **Post date:** [August 27, 2026, 1:43pm UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/8 "2026-08-27T13:43:30Z")
Hi @pehughes - I’ve sent you a private message. ---
**Author:** ![digitallysimple](https://avatars.discourse-cdn.com/v4/letter/d/f4b2a3/32.png) [@digitallysimple](https://developer.squareup.com/forums/u/digitallysimple)\ **Post date:** [September 17, 2026, 4:18am UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/9 "2026-09-17T04:18:01Z")
Hi Square Developer team, We’re building a membership and loyalty integration for breweries and taprooms, and would like to request access to the Discount Codes API, including `DISCOUNT_CODES_READ` and `DISCOUNT_CODES_WRITE`. Our use case is member perks such as one free beer per month or a free pour on a new release. The perk needs to be redeemable only by that member, able to be saved for a later visit if they decline it today, and applied natively in Square POS so staff never leave the register. We’ve tested the public options and neither works. `CatalogPricingRule` with `customer_group_ids_any` gives correct customer gating but always auto-applies, so there is no way to defer. Loyalty reward tiers are deferrable but `LoyaltyProgramRewardTier`has no eligibility field, so any account with enough points can redeem any tier. A customer-attached discount code looks like the right mechanism for this. Calls to `/v2/discount-codes` currently return `NOT_FOUND` for our application, and we’ve seen previous forum posts indicating access may be available by special request. Could someone from the Square team please assist with the process for requesting access for our application? Happy to provide our application ID and further details about our use case privately. Thanks. ---
**Author:** ![jseok](https://avatars.discourse-cdn.com/v4/letter/j/f475e1/32.png) [@jseok](https://developer.squareup.com/forums/u/jseok)\ **Post date:** [September 17, 2026, 5:27pm UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/10 "2026-09-17T17:27:25Z")
Hi @digitallysimple - the Discount Codes API has not yet been released in GA! I’ve sent you a DM for more details to get you enrolled. ---
**Author:** ![henri\_ocus](https://avatars.discourse-cdn.com/v4/letter/h/74df32/32.png) [@henri\_ocus](https://developer.squareup.com/forums/u/henri_ocus)\ **Post date:** [September 24, 2026, 2:07pm UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/12 "2026-09-24T14:07:50Z")
Hi Jseok and Square Developer team, I’m an engineer at Ocus, we’re developing a Square integration to tracking Ads performance for our Clients. To do this, we would need the Discount Codes API, including DISCOUNT\_CODES\_READ and DISCOUNT\_CODES\_WRITE. For now, we are using Customer Group discount as a workaround, but that won’t work with Online Order as far as I understand. Many thanks ! ---
**Author:** ![bobisback](https://avatars.discourse-cdn.com/v4/letter/b/977dab/32.png) [@bobisback](https://developer.squareup.com/forums/u/bobisback)\ **Post date:** [September 28, 2026, 1:08am UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/13 "2026-09-28T01:08:30Z")
any chance I can get access to this api as well? ---
**Author:** ![chocondip](https://avatars.discourse-cdn.com/v4/letter/c/919ad9/32.png) [@chocondip](https://developer.squareup.com/forums/u/chocondip)\ **Post date:** [October 4, 2026, 9:17pm UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/14 "2026-10-04T21:17:42Z")
Hi @jseok and Square Developer Team, Could you please help us request special access to the Discount Codes API, including DISCOUNT\_CODES\_READ and DISCOUNT\_CODES\_WRITE? Please let us know the access requirements and how to provide application details privately. We would also appreciate documentation confirming whether API-issued codes support redemption on Square Register in Canada and whether a reward can be restricted to exactly one item unit per redemption. Thank you! ---
**Author:** ![garrettfrombizmeet](https://avatars.discourse-cdn.com/v4/letter/g/90db22/32.png) [@garrettfrombizmeet](https://developer.squareup.com/forums/u/garrettfrombizmeet)\ **Post date:** [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/15 "2026-10-06T13:06:42Z")
@jseok would love to get api access here as well. Working on some creator marketing workflows and would be AMAZING to issue discount codes per creator automatically for our customers when they accept a creator. What is the process for that look like? ---
**Author:** ![duyngoc834](https://avatars.discourse-cdn.com/v4/letter/d/858c86/32.png) [@duyngoc834](https://developer.squareup.com/forums/u/duyngoc834)\ **Post date:** [October 19, 2026, 4:28pm UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/16 "2026-10-19T16:28:13Z")
Hi @jseok , We’d love to get API access as well! We’re working on a feature to automatically generate discount codes for our customers on a monthly basis, each with a defined expiration date. Having API access would help us automate this process. ---
**Author:** ![PinheadsRyne](https://avatars.discourse-cdn.com/v4/letter/p/3ab097/32.png) [@PinheadsRyne](https://developer.squareup.com/forums/u/PinheadsRyne)\ **Post date:** [October 26, 2026, 5:14pm UTC](https://developer.squareup.com/forums/t/discount-codes-read-write-oauth-scopes-present-but-v2-discount-codes-returns-not-found/27250/17 "2026-10-26T17:14:23Z")
Hi @jseok and Square Developer Team, We’re developing a merchant integration and would like to request access to the Discount Codes API, including DISCOUNT\_CODES\_READ and DISCOUNT\_CODES\_WRITE. Our use case involves unique, single-use promotional codes displayed in a third-party mobile app. We’d like staff to scan these directly on Square Handheld, validate eligibility, and apply the associated discount without leaving Square POS. Could you confirm whether this workflow is supported and how we can request access? We’d also appreciate documentation covering redemption limits and linking redeemed codes to their associated orders. I’m happy to share our application ID, merchant information, and detailed requirements through a private support channel. Thank you!