> For the complete documentation index, see [llms.txt](https://claimlane-docs.gitbook.io/claimlane-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://claimlane-docs.gitbook.io/claimlane-docs/troubleshooting-and-faqs/how-to-connect-shopify.md).

# How to connect Shopify

Learn how to enable custom apps and set up the Claimlane app in Shopify by creating the app and configuring the required API permissions.

### Allowing custom app before setup

Before you begin, make sure you've allowed custom apps.\
​You do this in the Apps section, which you will find on the left side:

![](https://downloads.intercomcdn.com/i/o/tbixbicd/1348286435/4b7e360900018f948f758a2bb010/image-png-Jul-11-2024-01-05-58-1855-PM.png?expires=1759142700\&signature=0d5470b7f782e15c9e16dd2aac1995a2106912be960ff84ea070fcff68c107bd\&req=dSMjHst2m4VcXPMW1HO4zRbe31MkQi2pq0YktmN97iIJOZLJhJivCagqd%2BGR%0AcSrw%0A)

Then click on Apps and Sales channels

![](https://downloads.intercomcdn.com/i/o/tbixbicd/1348286427/ac457ca011b201f51eadb37df6d6/image-png-Jul-11-2024-01-06-17-4434-PM.png?expires=1759142700\&signature=9c75fa16e0cac5fdccb84b6aae2cbcf2279a87a5fa00c1314dc759969656fc6e\&req=dSMjHst2m4VdXvMW1HO4zdQJuQ%2BsyBtAVh0E5PlKdj1h8vigLOHlicUyLG1j%0A3%2BuM%0A)

Click on Develop Apps:

![](https://downloads.intercomcdn.com/i/o/tbixbicd/1348286420/e895d1bf2f68db893b04d4de906c/image-png-Jul-11-2024-01-07-06-3049-PM.png?expires=1759142700\&signature=d8aab8728a3895aab4ff788bfb2336b653d35cd0bf8c127a41004de7cd0f9a09\&req=dSMjHst2m4VdWfMW1HO4zSXSgMUlmAugz6GpMMQSt6GgB%2BhPY1s2dlbvPidE%0Ar9kT%0A)

### Setting up Shopify

Click on Create an app which is located in the top right corner:

![](https://downloads.intercomcdn.com/i/o/tbixbicd/1348286424/e83d87dd9777a4972c633476f530/image-png-Jul-11-2024-01-07-35-8468-PM.png?expires=1759142700\&signature=426b4f2d6518c85d5ce00803501b9d724769c50a20362f5ea59c1eebf503e600\&req=dSMjHst2m4VdXfMW1HO4zQd45ZcEI2QXcecQbHShl0ugcYf5TfL%2BNtbU%2Flie%0AY3ZS%0A)

Name the app 'Claimlane' and choose the app developer. In most cases, you will only have one to choose from:\
​

![](https://downloads.intercomcdn.com/i/o/tbixbicd/1348286442/1c8ed2bfc50764061163a35d8db7/image-png-Jul-11-2024-01-08-06-2032-PM.png?expires=1759142700\&signature=27860257bdeaefb8c44cb7edc389c80027f7b4d38e34ba5ddc88e9118f660265\&req=dSMjHst2m4VbW%2FMW1HO4zT1Tq6SuvZzu0xwojv0U65Cq%2BESVMxnVNnE9pegq%0A8WGp%0A)

Once done, tap on Create app.

![](https://downloads.intercomcdn.com/i/o/tbixbicd/1348286428/64944662561126a9221af020e9cb/image-png-Jul-11-2024-01-11-02-8620-PM.png?expires=1759142700\&signature=386853a6a568f552d36656ba564afb959e0926e6e132738e3e8aa2efed9eb2ad\&req=dSMjHst2m4VdUfMW1HO4zYvKdV2jMteNTJRHoA5ofEhqZiZLRx76QaEouRuH%0AFClV%0A)

Then you will have this image:\
​\
Firstly, click on

![](https://downloads.intercomcdn.com/i/o/tbixbicd/1348286434/97e020170d8134cc4a66f31933bf/image-png-Jul-11-2024-01-12-36-3021-PM.png?expires=1759142700\&signature=3c1be8649c0e09dbcf75c2823269d7014a870a17503671a78f6efd7b063f64cd\&req=dSMjHst2m4VcXfMW1HO4zTBOPHa%2FwFvwhBki1N%2Bt6R3jb%2FQQRtxR9Pr%2BhPGK%0A67Wk%0A)

Configure/edit Admin API Scopes:\
​\
Here you must check the following boxes:

* write\_customers
* ​write\_orders
* read\_products
* read\_customers
* read\_orders
* write\_discounts
* read\_discounts
* write\_price\_rules
* read\_price\_rules
* write\_gift\_cards
* read\_gift\_cards
* read\_inventory
* write\_inventory
* read\_locations

If you wish the Shopify Replace feature, we need the following scopes aswell:

* read\_returns
* write\_returns
* read\_assigned\_fulfillment\_orders
* write\_assigned\_fulfillment\_orders

Once you have done that, make sure that your Webhook subscription is set to the latest version.

\
Click Save in the top right of the page.

![](https://downloads.intercomcdn.com/i/o/tbixbicd/1348286443/dfa0f75d1649b3392dac81bb94f4/image-png-Jul-11-2024-01-16-30-3180-PM.png?expires=1759142700\&signature=554428aedfdbe717c6bd1bc26ca5277874d04bcc9aad46ae17853b7bdfe90e43\&req=dSMjHst2m4VbWvMW1HO4zZwCUR3FtrrXniPbNiNgrMRvq9Ogac7ZcECXtGCS%0A10vr%0A)

Click install app in the top right corner:(or just save if already installed)

Finally, go to Admin API access token and click

![](https://downloads.intercomcdn.com/i/o/tbixbicd/1348286423/7bca89a6b32afab6f684f6019bd5/image-png-Sep-26-2024-11-42-07-5753-AM.png?expires=1759142700\&signature=67756953ed74ae3dc2e92e31a7aa0fac191e2b4b02ca8df2c7246c396ad24b6e\&req=dSMjHst2m4VdWvMW1HO4zdLECDnb7rZwqc5BZOr%2BUk5khMM07S85MZOzHsdi%0A9EBw%0A)

Reveal token once:\
​\
Send this to claimlane along with the URL for the specific shopify shop