> 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FfiRoZwHmtPUDYkbuefQ7%2Fimage.png?alt=media&amp;token=bad20d40-ee91-426e-addd-cd1c188cd62e" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2Ft7Ee59tfjvd4XhLdSz8d%2Fimage.png?alt=media&amp;token=2eea35d6-5e1c-4312-96b2-38decc36fc2f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FYLUI8FQ76HzanUIlFcfL%2Fimage.png?alt=media&amp;token=b018a00f-e745-4478-9cb7-eac9c6e54936" alt=""><figcaption></figcaption></figure>

3. Enter app details

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

<figure><img src="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FBo9Ro8BDzlfMas8DRodq%2Fimage.png?alt=media&amp;token=d3bbdb64-5a00-49f9-b2d4-85be95d186a8" 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2Fn8dEmcvUQdzn0aGmAxLf%2Fimage.png?alt=media&amp;token=fa19bcd1-4874-4324-abcc-bd0d92ed1e5d" 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2F7oMZtf4zPEdHJjtcs6Ne%2Fimage.png?alt=media&amp;token=93fd900a-19f7-4566-874f-d0580306305f" 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FI7LP80vaaI70s6ezliAq%2Fimage.png?alt=media&amp;token=649616d0-56f5-43ec-b916-3a2528fc8930" 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FLrXPZ8GFKf9dXTPugLRo%2Fimage.png?alt=media&amp;token=33063d94-4687-4fff-a52d-a36304049608" 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FTwktkWG3Nn4PtDVaKhvL%2Fimage.png?alt=media&amp;token=6e36df62-e12a-4f79-8b66-ae4cde014737" 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FKVewMqNB4JVX3z5tFi0W%2Fimage.png?alt=media&amp;token=55500652-fa71-41d8-9534-496594e32618" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FmGwA2bWo8KbrblAILn5p%2Fimage.png?alt=media&amp;token=9ef4c01b-8a9a-459a-873c-20e4e84e734f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FP09TotwYxkGMIxYkp8YU%2Fimage.png?alt=media&amp;token=c6e882cd-1b3a-4090-b9a3-59f8e5432d1c" 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FgRlITicB5NjYcPoOfPwV%2Fimage.png?alt=media&amp;token=607181cf-5911-494b-86cd-81d4a53eefe7" alt=""><figcaption></figcaption></figure>

3. Click **Create transfer**

<figure><img src="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FMsTj0R56YIRyPBG8InNr%2Fimage.png?alt=media&amp;token=53f2b90b-f4a5-422a-be1d-63ea32374997" 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FsfTnTNBtcuP9LktHoqA6%2Fimage.png?alt=media&amp;token=eb28259c-e28a-4e45-ad95-68f676a89d9d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FN2tmjAoCbQLv7nVnewro%2Fimage.png?alt=media&amp;token=dae33f67-ace6-4ef5-bd37-656d9af5afcc" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FE6rlqepekUqgZhEkGGxv%2Fimage.png?alt=media&amp;token=fe20c415-3281-4b53-8d8a-9d961074167e" 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="https://2318597655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfX5kwAozsDkn9XG4qEC3%2Fuploads%2FTxT90MkqmV6Ed4bZyE3H%2Fimage.png?alt=media&amp;token=c1842efe-16a0-4492-99de-854619425eb0" 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.