# Stage 1: Create a Shopify app/sales channel for Patchworks

## Introduction

In Shopify, you need to create an app/sales channel for Patchworks and then grant access for Patchworks to access your data. This is completed in two parts:

* [Part 1: Shopify Admin API scopes](#part-1-shopify-admin-api-scopes). Create a Patchworks app/sales channel and enable general API scopes for Patchworks to access your data.
* [Part 2: Shopify Storefront API scopes](#part-2-shopify-storefront-api-scopes). Enable specific scopes for Patchworks to access products associated with the Patchworks app/sales channel.

## Part 1: Shopify Admin API scopes

*Admin API* scopes must be set to allow the Shopify connector to access your data via the Shopify Admin API. This is a standard requirement for the Shopify connector, irrespective of whether it's been installed as part of an app or as a standalone connector. 

Please follow the steps detailed on our [Shopify (prebuilt connector)](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/shopify-prebuilt-connector) page under *Obtaining credentials*, then go to [Part 2](#part-2-shopify-storefront-api-scopes). 

## Part 2: Shopify Storefront API scopes

*Storefront API* scopes are not required for general use but they ARE needed for the *Shopify & Virtualstock Supplier* blueprint. Please follow the steps below to grant the required access permissions.

**Step 1**\
Still in the Shopify admin portal with your Patchworks app/integration, select the *review configuration* option from the *overview* tab:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FlpX19zE9KIRR4teJChxv%2Fshopify%20setup%201a.png?alt=media&#x26;token=798d9896-500a-491b-8f86-f632ff28d120" alt=""><figcaption></figcaption></figure>

**Step 2**\
Scroll to the end of the page and select the *configure* button for *Storefront API integration*:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fz44xMAGR3FnByTnq5N6G%2Fshopify%20setup%202.png?alt=media&#x26;token=9d71c4c4-cd50-4cc1-a66f-0f6395dc9826" alt=""><figcaption></figcaption></figure>

**Step 3**\
In the list of scopes, scroll down to the *Products* section and enable the following three items:

* `unauthenticated_read_product_listings`
* `unauthenticated_read_product_inventory`
* `unauthenticated_read_product_tags`

For example:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FAkM33HZkBvSQXagdjj74%2Fshopify%20setup%203.png?alt=media&#x26;token=fa6f7027-b500-443a-9ee2-4244852cc585" alt=""><figcaption></figcaption></figure>

**Step 4**\
Save your changes.

**Step 5**\
Go to the [next stage](https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier/installation-guide-shopify-and-virtualstock-supplier/stage-2-add-required-products-to-your-patchworks-sales-channel-shopify-and-virtualstock-supplier).