# 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.&#x20;

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

## 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="/files/JSSvqybxinSYd2fDHBom" 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="/files/DVrvz6LTy0K7B8HPuAdn" 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="/files/mmSiOEpJo8hU8t78rQAw" alt=""><figcaption></figcaption></figure>

**Step 4**\
Save your changes.

**Step 5**\
Go to the [next stage](/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.md).


---

# Agent Instructions: 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:

```
GET https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier/installation-guide-shopify-and-virtualstock-supplier/stage-1-create-a-shopify-app-sales-channel-for-patchworks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
