> For the complete documentation index, see [llms.txt](https://help.palmstreet.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.palmstreet.app/~/changes/185/seller/seller-tools/how-to-connect-your-shopify-store-to-palmstreet.md).

# How to connect your Shopify store to Palmstreet

To connect your Shopify store to Palmstreet, start by installing the Palmstreet custom app and setting up a separate store location in Shopify. This ensures your product listings and inventory stay in sync automatically across both platforms, so everything stays accurate without manual updates.

## Part 1: Install the Palmstreet Custom App

#### Step 1: Create a Custom App

1. Navigate to the app creation menu by clicking on **App and sales channel settings** in your Shopify store and click on **Apps**

<figure><img src="/files/ZdwjbRPfkTx6VBCEv9OC" alt=""><figcaption></figcaption></figure>

2. Go to **Develop apps** and select **Create an app**

<figure><img src="/files/9wWHMRYpaeCgfalva2sZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OsJDHBeJ0mBicUCsc3aH" alt=""><figcaption></figcaption></figure>

3. Enter app details

* **App name:** `Palmstreet`
* **App developer:** `Jason Li (jason@palmstreet.app)`&#x20;

<figure><img src="/files/FadvfSMYdzWMfYHfaQrQ" alt=""><figcaption></figcaption></figure>

4. Click the **Create app** to confirm and complete the setup process

#### Step 2: Configure the API Scopes

1. Go to the app you just created and go to **Configuration** and select **Configure Admin API scopes**

<figure><img src="/files/KZ0o5ieVD0225yCNoLAT" alt=""><figcaption></figcaption></figure>

2. Grant *Read* access to the following API scopes:

* `write_product_listings`
* `read_product_listings`
* `write_products`
* `read_products`
* `read_locations`
* `write_locations`
* `write_inventory`
* `read_inventory`

3. Click **Save** once all scopes have been added and the correct permissions granted

<figure><img src="/files/XDF3Iszfu1jXa86gCah1" alt=""><figcaption></figcaption></figure>

4. Navigate to API Credentials and click Install App to complete the configuration

#### Step 3: Input Store Information into Palmstreet and Generate the App URL

1. Log In to Palmstreet **Seller Hub**
2. Go to the **Integration** > **Settings** to connect your Shopify store

<figure><img src="/files/IA8yhMjjb8Az1dIXbv9e" alt=""><figcaption></figcaption></figure>

3. Follow the instructions and enter store details

* **Shopify Store Name:** Enter your Shopify store name in the designated field (e.g., `psmyshopify.com`)
* **Admin API Access Token:** Copy and paste your **Admin API access token** into the corresponding field
* **API Secret Key:** Copy and paste your **API secret key** (Please note that this is the **API secret key**, *not* the API key)

<figure><img src="/files/Cnfa8oQzwJgXyZoRPpWS" alt=""><figcaption></figcaption></figure>

4. Click **Connect** to finalize the integration and generate the app URL

### Part 2: Create location for Palmstreet on Shopify

To ensure Palmstreet can manage your inventory and fulfill orders correctly, you’ll need to create a store location within Shopify. To do this, log in to your Shopify store, navigate to **Settings** to begin the setup.

<figure><img src="/files/16efTvFphUWfOjhNAYaK" alt=""><figcaption></figcaption></figure>

#### Step 1: **Add a New Location**

1. In Shopify, navigate to **Settings > Locations**
2. Click **Add location**
3. Enter the **Name** and **Address** for the new location
4. Follow the on-screen instructions to save the location details

<figure><img src="/files/ME1v7nn53YpyzCo2Nykc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ls0ijFmAzNyGjpJ5Wb9U" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/nTelrGceLneG5QKFy1II" alt=""><figcaption></figcaption></figure>

#### Step 2: **Assign Products to the Palmstreet Location**

1. In Shopify, navigate to **Products > Inventory**
2. Select all products you want to add to your newly created Palmstreet location

<figure><img src="/files/K87CQuY9dOBsZgNXVtAc" alt=""><figcaption></figcaption></figure>

3. Click **Create transfer**

<figure><img src="/files/vSTblHFANqzip2SoplSx" alt=""><figcaption></figcaption></figure>

#### Step 3: Complete the Transfer

1. Choose the **origin inventory** location
2. Set the **Palmstreet store location** you created as the destination

<figure><img src="/files/Mbe2WT3HHtKbQf8A4mg3" alt=""><figcaption></figcaption></figure>

3. Click **Mark as > Transferred** to confirm the transfer to complete the process

<figure><img src="/files/K4iGmAT6JLbnHgFsIZ58" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/hizPSkNVHCnPBnSTYqLi" alt=""><figcaption></figcaption></figure>

#### Step 4: Sync the Location with Palmstreet

1. In your Palmstreet **Seller Hub**, select the corresponding location you created in Shopify
2. Click **Sync to Palmstreet** to complete the integration

<figure><img src="/files/vEvvAgB1NVuXdABp7dNg" alt=""><figcaption></figcaption></figure>

*If you need help syncing your Shopify inventory to Palmstreet, check out our article on* [***How to Sync Shopify Inventory to Palmstreet***](https://help.palmstreet.app/~/changes/186/seller/seller-tools/how-to-sync-shopify-inventory-to-palmstreet)***.***

### FAQ

**Why do I need to create a separate store location for Palmstreet in Shopify?**\
Creating a separate location lets you choose exactly which product listings you want to make available on Palmstreet. This setup won’t affect your overall inventory sync in Shopify. (**awaiting pm confirmation**)

**What’s the difference between the API key and API secret key?**\
The API key identifies your app, while the API secret key is used for authentication. Be sure to use the **API secret key** when connecting to Palmstreet.

**How often does inventory sync between Shopify and Palmstreet?**\
Inventory syncs automatically in near real time once your store is connected and locations are properly set up.&#x20;

**What should I do if my inventory isn’t updating in Palmstreet?**\
First, ensure the products are assigned to the Palmstreet location in Shopify and that the location is synced in the Palmstreet Seller Hub. If issues persist, see our article on [**How to Sync Shopify Inventory to Palmstreet**](/~/changes/185/seller/seller-tools/how-to-sync-shopify-inventory-to-palmstreet.md) or contact our support team **@PalmstreetSupport** for further assistance.&#x20;

**Still need help?**

If your question wasn’t answered here, our Support team is always happy to help. You can also browse the [Help Center](https://help.palmstreet.app/) for more resources and commonly asked questions.