# Shopify custom app

A [Shopify custom app](https://help.shopify.com/en/manual/apps/custom-apps) can be connected to Funnelish by going through [**Account > Integrations > Shopify**](https://app.funnelish.com/integrations/5) then clicking on **"Connect using a custom app..."**

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FGYxcbC5BJ2RCMq92w52p%2Fimage.png?alt=media&#x26;token=c30dcb18-50b3-436e-b19b-d02d2455231a" alt=""><figcaption></figcaption></figure>

### Creating a Shopify custom app

Now let's head to Shopify to create our custom app and get the credentials needed to connect it to Funnelish.

1. Go to your Shopify store and click on **Apps** > **App and Sales channel settings.**

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2Fe8aSJ6WayY8zScxbPTss%2Fimage.png?alt=media&#x26;token=fb4f38d6-571d-4926-a7e9-7b9775b68916" alt=""><figcaption></figcaption></figure>

2\. Click **Develop apps for your store.**

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FWL3s6IrJOKmImSrVPGUf%2F2022-10-17%20at%2014.06.png?alt=media&#x26;token=03a2a506-0a89-437c-830e-bd4098df0f30" alt=""><figcaption></figcaption></figure>

3\. If it's first time creating a custom app, you'll be asked to **allow custom app developments first.**

![](https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FVdeleidgpZQYZcTqiyu9%2F2022-10-17%20at%2014.09.png?alt=media\&token=f6938d39-72aa-4953-9892-5adda3bb6f65)

4\. Click **Create an app** and give it a name, eg. "Funnelish".

### Assign access scopes

Once the app is created we need to assign it certain access scopes for it to have access to your store to create orders and list products.

1. Click **Configure Admin API scopes** inside the app panel.

&#x20;![](https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FuKhNtajxR6mRCsXEgtTX%2F2022-10-17%20at%2014.17.png?alt=media\&token=217d3ea9-93ac-41d5-8637-974de2d5b4f4)

2\. Assign the following permissions:

* &#x20;`read_products`, `write_products`
* &#x20;`read_orders`, `write_orders`
* &#x20;`read_customers`, `write_customers`
* `read_fulfillments`, `write_fulfillments`

Once these are selected click **save.**

### Install the custom app

Now we are ready to install the app and connect it to Funnelish.

1. Click **Install app.**&#x20;

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FnXEQwT3BjwQSFslvlrzu%2Fimage.png?alt=media&#x26;token=a6ce610f-3977-4207-943c-de101f5eb4df" alt=""><figcaption></figcaption></figure>

2\. You'll be given a token, click **Reveal token once** and then **copy** it.

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2F4i8Uov0gLFWf3TrUji4g%2Fimage.png?alt=media&#x26;token=3920b0f3-60f8-431c-aa8e-ee45c68b6a46" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
The access token is shown only once, make sure to copy it into Funnelish. Otherwise you'll need to recreate a new custom app.
{% endhint %}

3\. Also, copy the **API Key** and  **API secret key** into Funnelish as wel&#x6C;**.**

![](https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2Fy5m0bVkASDW4wFGZCsyD%2F2022-10-17%20at%2014.41.png?alt=media\&token=d7a35d9c-9f52-40f1-89a8-9f97c4dd1010)

4\. Make sure to add your store name into Funnelish as well, either as: **storename** or **storename.myshopify.com**, both formats are valid.

Once all the details are added to Funnelish, click **Save Changes** and your Shopify store will be connected to your Funnelish account.

*If there is a problem connecting to your Shopify custom app, Funnelish will show an error popup with further details.*

Now it's time to set the product automations. Click [here](https://docs.funnelish.com/integrations/shopify/automate) to learn how to do this.