# 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.


---

# 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://help.palmstreet.app/~/changes/185/seller/seller-tools/how-to-connect-your-shopify-store-to-palmstreet.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.