> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/ecommerce/shopify/common-issues/shopify-invalid-credentials-or-missing-permissions.md).

# Shopify: Invalid credentials or missing permissions

### Shopify source

{% hint style="info" %}
Using connection created with Login to your Shopify store *(note: data flows created **after Dec 20, 2022)***
{% endhint %}

You may receive this error in case your Shopify source connection becomes invalid. To fix an error:

1. Navigate to the "Connections" page.
2. Find the Shopify connection used in the failed data flow.
3. Click the "Reconnect" button.
4. Enter shop name.
5. Login to Shopify (if needed).
6. Confirm connection creation.

Then you can rerun failed data flow - execution should finish with success.

### Shopify (legacy) source

{% hint style="info" %}
Using API key and password or API token without password *(note: data flows created **before Dec 20, 2022)***
{% endhint %}

**Firstly, define what application you use: private app or custom app. For this:**

1. Login to Shopify.
2. Login to the store.
3. Navigate to Apps.
4. Click the "Develop app for your store" button.
5. Find the app that you created for Coupler.io integration.
6. Check app type below the store name.

*Private app:*

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57fbf3029033600277a688ab/images/62002a22025ca67522c7860a/file-tgnFz2Ycr2.png)

*Custom app:*

![](https://s3.amazonaws.com/helpscout.net/docs/assets/57fbf3029033600277a688ab/images/620029d2d86136157d9a1644/file-G9sY7qsmA1.png)

**Quick tip:**

If you have a ***Private app***, you need to use ***API key*** and ***API password*** in the data flow's settings

If you have a ***Custom app***, you need need to use ***API token*** in the data flow's settings only, ***no password***

**Detailed steps to check:**

In case you have a **"Private app"** - please follow the next instructions:

**Step 1.** Please check that the "API key" and "API password" are copied from Shopify without typos.

**Step 2.** Please check the permissions granted to this API key. To do this:

1. Navigate to the "[Apps"](https://monosnap.com/file/Xm6lkix7DtSH7I4vcL2lpdMYLrLvQX) menu item.
2. Click the "Develop app for your store" button.
3. Select [the app that you created previously](https://monosnap.com/file/DmGMuSgYFKOxmQ0r1RexZOWXF4j9IM) to get the API key and password.
4. Please check [active permissions](https://monosnap.com/file/aFJz2d0Ot3HRb2YG4aNwaR6P3AYX68) that are defined for the application.

In case some permissions **are not active yet** - please activate them. For this follow the next steps:

1. Click " Show inactive Admin API permissions".
2. [Select "Read access"](https://monosnap.com/file/T1ln0eKUNyw1b2RPg208r2XyhC9a2H) for missed scope (i.e. Orders).

   ![](https://s3.amazonaws.com/helpscout.net/docs/assets/57fbf3029033600277a688ab/images/62d80653380b7a6b87b930ad/file-OJivk30iuj.png)
3. Save changes.

In case you have a **"Custom app"** - please follow the next instructions:

**Step 1.** Please check that the "API token" has no extra characters or spaces.

Note: API token can be copied 1 time during custom app setup. So if you did no store the API token - you need to create a new custom app and be sure that you copy the API token this time!

**Step 2.** Please check that you left the "API password" field empty in the data flow settings.

**Step 3.** Please check the permissions granted to this API token. To do this:

1. Navigate to the "[Apps"](https://monosnap.com/file/Xm6lkix7DtSH7I4vcL2lpdMYLrLvQX) menu item.
2. Click the "Develop app for your store" button.
3. Select [the app that you created previously](https://monosnap.com/file/DmGMuSgYFKOxmQ0r1RexZOWXF4j9IM) to get API token.
4. Navigate to the "Configuration" tab.
5. Check used permissions:

   ![](https://s3.amazonaws.com/helpscout.net/docs/assets/57fbf3029033600277a688ab/images/62002b49025ca67522c7860d/file-dttcIpfPbo.png)
6. In case your permissions are different from the list *"read\_inventory, read\_orders, read\_products, read\_customers"*: edit the configuration to include missed permissions.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/ecommerce/shopify/common-issues/shopify-invalid-credentials-or-missing-permissions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.