# Creating Shopify private app

The setup defined below is required to establish connectivity with your Shopify store and Molecule Data tool. This process grants Molecule Data as a custom application so order data can be transmitted to/from Shopify and Molecule Data.

1. In your Shopify store admin section, navigate to Apps and click "**Apps and sales channels settings"** at the bottom.

<figure><img src="https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2F4yvJSPxIkZWvikZ8tizh%2FScreenshot%202024-03-25%20at%2015.47.31.png?alt=media&#x26;token=893d2f28-1b3c-4835-a45f-85db9e5cadda" alt=""><figcaption><p>Navigating to Apps</p></figcaption></figure>

2. Click the **"Develop app"** button at the top of the page.

<figure><img src="https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2FJW8yjcBVaZUAmJf0UPCk%2FScreenshot%202024-03-25%20at%2015.53.14.png?alt=media&#x26;token=59031329-870f-419a-ad57-b6e9ac9e0dde" alt=""><figcaption><p>Custom Apps section</p></figcaption></figure>

3. Click the **"Create an app"** button.

<figure><img src="https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2FM5dImkU6QfyCYX1uzY7V%2FScreenshot%202024-03-25%20at%2015.54.11.png?alt=media&#x26;token=01bc935e-9d8f-4df0-92b2-12b075406302" alt=""><figcaption><p>Create an app section</p></figcaption></figure>

4. Type the name of the app. We recommend using "**Molecule Data**" as the name. Type the email.

{% hint style="info" %}
The Emergency developer email should be your (the customer’s) email information.
{% endhint %}

<figure><img src="https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2FXTjjfG5AO4m7dKwr7MkJ%2FScreenshot%202024-03-25%20at%2015.54.45.png?alt=media&#x26;token=dbe0d19d-8567-465d-af55-015f5331bcba" alt=""><figcaption><p>Giving app name</p></figcaption></figure>

5. In the Access scopes section, click "**Configure Admin API scopes**" button and set the following permissions to allow order import, fulfilment, and inventory updates. Use the scroll bar to access each permission setting as needed.

<figure><img src="https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2FXnbMLXjWSWsjtFB9wylB%2FScreenshot%202024-03-25%20at%2015.55.30.png?alt=media&#x26;token=8abc0bef-2007-4b03-9af6-d006d72a3a66" alt=""><figcaption><p>Navigating to Admin API scopes section</p></figcaption></figure>

6. Select the permissions listed below:

| Permissions                                  |
| -------------------------------------------- |
| read\_analytics                              |
| read\_assigned\_fulfillment\_orders          |
| read\_customer\_events                       |
| read\_customers                              |
| read\_discounts                              |
| read\_discovery                              |
| read\_draft\_orders                          |
| read\_fulfillments                           |
| read\_gift\_cards                            |
| read\_inventory                              |
| read\_locations                              |
| read\_marketing\_events                      |
| read\_merchant\_managed\_fulfillment\_orders |
| read\_orders                                 |
| read\_packing\_slip\_templates               |
| read\_pixels                                 |
| read\_price\_rules                           |
| read\_product\_feeds                         |
| read\_product\_listings                      |
| read\_products                               |
| read\_purchase\_options                      |
| read\_reports                                |
| read\_returns                                |
| read\_channels                               |
| read\_shipping                               |
| read\_locales                                |
| read\_shopify\_payments\_disputes            |

<figure><img src="https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2FVKzT7dN5rW2alWY1f6kt%2FScreenshot%202024-03-25%20at%2016.10.07.png?alt=media&#x26;token=9a46c934-942a-454c-8c79-f0ba4fb1f2c8" alt=""><figcaption><p>Selecting Custom app API scopes</p></figcaption></figure>

7. Click the **Save** button to save the new permissions and application entries.

**Now you have successfully created and configured your custom app.**

8. Now that your app is ready, you need to **install** the app and **add the provided API keys** into Molecule Data Shopify Integration section.

<figure><img src="https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2FTcxso1VnjFo5Rww7n91W%2FScreenshot%202024-03-25%20at%2016.13.19.png?alt=media&#x26;token=db44a22c-2b0b-4ad9-baa8-245e6e10d717" alt=""><figcaption><p>Intalling the Custom app</p></figcaption></figure>

9. Copy the "**Shared Secret token**" key.

<figure><img src="https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2FB8ZlaDRpPIlaXyrh0CIL%2FScreenshot%202024-03-25%20at%2016.19.55.png?alt=media&#x26;token=f7c11151-a7df-4176-8d87-eef9ac881951" alt=""><figcaption><p>Retrieving the Shared Secred token</p></figcaption></figure>

10. **Paste** it in the Molecule Data Shopify integration section.

<figure><img src="https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2FT1LeNEeAB0ya0KifDZQh%2FScreenshot%202024-03-25%20at%2016.42.53.png?alt=media&#x26;token=f6aa2417-e6cb-4c42-88fd-5abc7848d127" alt="" width="375"><figcaption><p>Adding credentials into Molecule Data integration section</p></figcaption></figure>

{% hint style="info" %}
The Shop name can be easily found in the admin URL of the shop.

![](https://1364162697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUc1DhBGYxkrTzRj7xZKQ%2Fuploads%2F9Q8KTvNT053S1QTz6HYJ%2FScreenshot%202024-03-25%20at%2016.18.26.png?alt=media\&token=a31facf1-b20a-44fa-b227-b07e8129fde2)
{% endhint %}

You are **done**!