# 403 Insufficient Permissions on Orders API

**URL:** <https://developer.squareup.com/forums/t/403-insufficient-permissions-on-orders-api/24618>\
**Category:** Questions\
**Tags:** orders-api\
**Created:** [November 24, 2025, 6:42am UTC](https://developer.squareup.com/forums/t/403-insufficient-permissions-on-orders-api/24618 "2025-11-24T06:42:52Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![hwww](https://avatars.discourse-cdn.com/v4/letter/h/258eb7/32.png) [@hwww](https://developer.squareup.com/forums/u/hwww)\
**Post date:** [November 24, 2025, 6:42am UTC](https://developer.squareup.com/forums/t/403-insufficient-permissions-on-orders-api/24618/1 "2025-11-24T06:42:52Z")

</div>

Hi everyone,

I am building an internal integration for my own shop to sync daily sales from Square POS to a Google Sheet using Google Apps Script.

I am receiving the following error when making a request to [https://connect.squareup.com/v2/orders/search:](https://connect.squareup.com/v2/orders/search:)

“Error: You have insufficient permissions to perform that action.”

The Weird Part (Troubleshooting so far):  
The credentials work perfectly for other endpoints.  
I tested the exact same Production Access Token and Location ID in a script to fetch my inventory (using v2/catalog/list and v2/inventory/counts), and it returned data successfully.

The 403 error only happens when I attempt to access the Orders API.

My Setup:

1. I am the Owner of the Square account.

2. I created the App in the Developer Dashboard myself.

3. I am using the Production Access Token (Personal Access Token), not OAuth.

4. I have verified that the dashboard toggle is set to “Production” and the token starts with EAAA.

The Failing Code:  
I am using Google Apps Script (UrlFetchApp). Here is the request structure that fails:

codeJavaScript

```auto
const url = 'https://connect.squareup.com/v2/orders/search';

const payload = {
  "location_ids": ["MY_LOCATION_ID"], 
  "query": {
    "filter": {
      "state_filter": {
        "states": ["COMPLETED"]
      },
      "date_time_filter": {
        "closed_at": {
          "start_at": "2023-10-25T00:00:00.000Z", 
          "end_at": "2023-10-25T23:59:59.999Z"
        }
      }
    }
  }
};

const options = {
  "method": "post",
  "contentType": "application/json",
  "headers": {
    "Authorization": "Bearer " + "MY_ACCESS_TOKEN", 
    "Square-Version": "2023-10-20"
  },
  "payload": JSON.stringify(payload),
  "muteHttpExceptions": true
};

```

The Question:  
Since this is a Personal Access Token for the account owner, shouldn’t it have global permissions? Why would it allow me to read Inventory/Catalog but block me from reading Orders?

Is there a manual scope setting I need to toggle in the dashboard even for Personal Access Tokens?

Any guidance would be appreciated. Thanks!

---

<div class="post-metadata">

**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\
**Post date:** [November 24, 2025, 6:43am UTC](https://developer.squareup.com/forums/t/403-insufficient-permissions-on-orders-api/24618/2 "2025-11-24T06:43:01Z")

</div>

👋 I’m Square Dev AI, here to help answer your question!  
Based on the information you’ve provided, the following documentation will help answer your question:

> **[OAuth Permissions Reference](https://developer.squareup.com/docs/oauth-api/square-permissions)**
>
> Reference for all OAuth permissions (scopes) needed to call Square API endpoints with an OAuth access token.

> **[Square Sandbox](https://developer.squareup.com/docs/devtools/sandbox/overview)**
>
> An overview of the Square Sandbox, which can be used to simulate orders, invoices, payments, and transactions in a test environment.

> **Additional Documentation**
>
> [OAuth API](https://developer.squareup.com/docs/oauth-api/how-it-works)  
> [OAuth API](https://developer.squareup.com/docs/oauth-api/how-oauth-works)  
> [OAuth API](https://developer.squareup.com/docs/oauth-api/overview)

If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.  
Otherwise one of our Developer Advocates will provide additional assistance shortly.

---

<div class="post-metadata">

**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\
**Post date:** [November 24, 2025, 4:28pm UTC](https://developer.squareup.com/forums/t/403-insufficient-permissions-on-orders-api/24618/3 "2025-11-24T16:28:26Z")

</div>

The issue you’re encountering is related to the permissions associated with the Personal Access Token. While Personal Access Tokens generally provide broad access to the account’s resources, there are specific APIs, like the Orders API, that require OAuth access tokens with explicit permissions.

Personal Access Tokens are suitable for accessing resources directly associated with your own Square account, such as inventory and catalog data. However, for accessing certain APIs like the Orders API, which might involve more sensitive data, Square requires the use of OAuth access tokens. These tokens are obtained through the OAuth flow and are scoped to specific permissions that you request during the authorization process.

To resolve this issue, you should:

1. Implement the OAuth flow to obtain an OAuth access token. This involves setting up an OAuth application in the Square Developer Dashboard and requesting the necessary permissions for the Orders API.

2. Use the OAuth access token in your requests to the Orders API. This token will have the appropriate permissions to access order data.

By following these steps, you should be able to access the Orders API without encountering the “insufficient permissions” error.

_This answer was reviewed by @Bryan-Square._

---

<div class="post-metadata">

**Author:** ![Bryan-Square](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/bryan-square/32/38_2.png) [@Bryan-Square](https://developer.squareup.com/forums/u/Bryan-Square)\
**Post date:** [November 24, 2025, 5:30pm UTC](https://developer.squareup.com/forums/t/403-insufficient-permissions-on-orders-api/24618/4 "2025-11-24T17:30:39Z")

</div>

What is the `location_id` your using in the `SearchOrders` request? 🙂

---

<div class="post-metadata">

**Author:** ![hwww](https://avatars.discourse-cdn.com/v4/letter/h/258eb7/32.png) [@hwww](https://developer.squareup.com/forums/u/hwww)\
**Post date:** [November 26, 2025, 7:43am UTC](https://developer.squareup.com/forums/t/403-insufficient-permissions-on-orders-api/24618/5 "2025-11-26T07:43:17Z")

</div>

Found a way to work around it. Thanks for the above reply.

---

<div class="post-metadata">

**Author:** ![Bryan-Square](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/bryan-square/32/38_2.png) [@Bryan-Square](https://developer.squareup.com/forums/u/Bryan-Square)\
**Post date:** [November 26, 2025, 5:16pm UTC](https://developer.squareup.com/forums/t/403-insufficient-permissions-on-orders-api/24618/6 "2025-11-26T17:16:53Z")

</div>

Glad to hear it’s working as expected. 🙂
