# Connecting Imonggo to Shopify

**Please note that these instructions are for the new v4 UI of Imonggo.**&#x20;

With this new Imonggo feature, you can decide what products in Imonggo are available for sale in your Shopify store. You may also send the sales you made on Shopify to your Imonggo account so you have a holistic view of your sales totals across the two services.

Here’s how to set it up:

### Step 1:

#### Activating the e-commerce integration feature

First, go to the **Shopify Integration** page in your Imonggo account’s **Settings**. Don’t know how to get to Settings? Just click the gear icon on the left side.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FCWiZ3rype8bHR1KE0WVA%2Fimage.png?alt=media&#x26;token=5f72686a-2857-4db1-9915-3ec03a7155b6" alt=""><figcaption></figcaption></figure>

### Step 2:

Go to the first section, **Shopify Integration**, and turn on the **Sync your order payments and products with Imonggo** switch.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FieFprGVqkGrr136pFBVo%2Fimage.png?alt=media&#x26;token=555dfbc7-6fd2-42ad-8465-23b19214c853" alt=""><figcaption></figcaption></figure>

### Step 3:

Scroll down to the next section.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FdrQA7i430ucCKq0M7SYG%2Fimage.png?alt=media&#x26;token=82424564-d0c4-4338-96ef-1e49157cde85" alt=""><figcaption></figcaption></figure>

As you can see above, there are five fields you need to fill up. **Click the tabs below** to learn how to get each information. Please accomplish the tabs in order.

{% tabs %}
{% tab title="Shopify Store name" %}
This one is the easiest to fulfill. To get the **Shopify Store Name**, just go to your Shopify account and copy the name of your store as it appears in the browser’s address bar. For example, our test store’s name is **faster tech**, but it appears as **faster-tech** on our browser’s address bar.

Just copy how it appears on the URL (do not include myshopify.com or the rest of the URL) and paste it onto the Shopify Store Name field in Imonggo.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FtJcFkqgiNNZIq8HnpFHD%2Fimage.png?alt=media&#x26;token=c19a124e-45db-4e81-b4d6-2888bc29035a" alt=""><figcaption></figcaption></figure>

![](https://3.128.202.144/wp-content/uploads/2019/06/faster-tech.png)

Go to the next tab to get the **Shopify Account API Key**.<br>
{% endtab %}

{% tab title="Shopify Account API Key" %}

### Step 1:

Go to the **Apps** page on your Shopify account.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FXjcjZJWGRIIpWncjEiYu%2Fimage.png?alt=media&#x26;token=db1b966b-ca5d-4370-b258-d0bb35258151" alt=""><figcaption></figcaption></figure>

### Step 2:

Click the **Manage private apps** link near the bottom of the **Apps** page.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FgtBOep8v83e3J3zMkMyX%2Fimage.png?alt=media&#x26;token=cef7bee6-1a33-4ed0-9d3e-e06b934e0e78" alt=""><figcaption></figcaption></figure>

![](https://3.128.202.144/wp-content/uploads/2019/02/002-Click-Manage-private-apps.png)

### Step 3:

In the next page, click the **Create a new private app** button.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FPWGgNceLPwK1ON0La9Cr%2Fimage.png?alt=media&#x26;token=2c7a67a2-ab24-409f-8856-b2bf328da961" alt=""><figcaption></figcaption></figure>

![](https://3.128.202.144/wp-content/uploads/2019/02/003-Create-a-new-private-app.png)

### Step 4:

The next page has three sections. The first section is **App details**. Enter the following:

**Private app name:** Imonggo

**Emergency developer email:** <support@imonggo.com>

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2Ftv7m9OZlELtsV3iKKrtd%2Fimage.png?alt=media&#x26;token=bae8fac7-836a-4b6d-b8a6-315201a3b7d3" alt=""><figcaption></figcaption></figure>

![](https://3.128.202.144/wp-content/uploads/2019/02/004-App-details.png)

### Step 5:

Then click the **Save** button on top-right save the initial settings.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2Fdbe73Kg2qhAFKPv2semG%2Fimage.png?alt=media&#x26;token=c33ace30-5803-4673-b0f8-1ee28849bb1d" alt=""><figcaption></figcaption></figure>

![](https://3.128.202.144/wp-content/uploads/2019/06/save-shopify-app-imonggo-1024x313.png)

### Step 6:

Confirm by clicking the **I Understand** button.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2F4XYY2GOm3zIBsUXguFQT%2Fimage.png?alt=media&#x26;token=12df2f76-9837-4228-b40c-aad2736a9a10" alt=""><figcaption></figcaption></figure>

![](https://3.128.202.144/wp-content/uploads/2019/06/i-understand-create-the-app-shopify-imonggo.png)

### Step 7:

Then scroll down to the second section, **Admin API**. It is a bit complicated, so please tread carefully. You have to copy the **API key** and the **Password** and paste them into the **Shopify Integration** page in your Imonggo account.

a. Copy the **API key** in Shopify…

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FMOWpzgx4dv8ejwYSJr9q%2Fimage.png?alt=media&#x26;token=a35ec47d-da7e-4f2b-aa29-28322903363d" alt=""><figcaption></figcaption></figure>

![](https://3.128.202.144/wp-content/uploads/2019/02/B0001-API-Key-a.png)

b. … and paste it in the **Shopify Account API Key** field on the Imonggo Shopify Integration page.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FgtNMQGfqXE9etyi58Kkw%2Fimage.png?alt=media&#x26;token=5742854d-4eac-40e3-8fb1-69c1f8994ca1" alt=""><figcaption></figcaption></figure>

![](https://3.128.202.144/wp-content/uploads/2019/06/shopify-account-api-key.png)

Go to the next tab to get the **Shopify Account API Password**.

{% endtab %}

{% tab title="Shopify Account API  Password" %}
**Please accomplish the last tab first before proceeding with this one.**

c. Copy the **Password** in Shopify…

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FVnAERzheHOEvHu1q4958%2Fimage.png?alt=media&#x26;token=a247aa58-62a1-4d57-bbac-6ac51d3f376d" alt=""><figcaption></figcaption></figure>

d. … and paste it in the **Shopify Account API Password** field in Imonggo.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2F63PNINLVNgKga9ZZk3tG%2Fimage.png?alt=media&#x26;token=fde8e583-22bf-4c0d-92a1-90314bb0c341" alt=""><figcaption></figcaption></figure>

e. Then click the **Save** button in Imonggo.

### Step 8:

Go back to Shopify and scroll down to the **Admin API Permissions** part of the Admin API section.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FxoYpu2e8gdFjTa2CHzVT%2Fimage.png?alt=media&#x26;token=2b08e650-3d10-4c0e-84e3-7a65261a64bd" alt=""><figcaption></figcaption></figure>

Copy the Permission types above. In summary:

* *Customers* should be on **Read and write**
* *Inventory* should be on **Read and write**
* *Orders* should be on **Read access**
* *Products* should be on **Read and write**
* *Store content* should be on **Read access**

### Step 9:

Then scroll to the last section of this page, called Storefront API. Leave it unchecked. Then click the **Save** button at the bottom right.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2Fmi7shm6TQpNGq2zpZDKV%2Fimage.png?alt=media&#x26;token=dee0ca7c-2f1a-422d-aa83-d05157c4e2f2" alt=""><figcaption></figcaption></figure>

Go to the next tab to get the **Shopify Webhook Token**.
{% endtab %}

{% tab title="Shipping Fee Stock No." %}
Getting the **Shipping Fee Stock No** should be easy.

### Step 1:

First, **create a product in Imonggo** that will stand as the Shipping item.

![](https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FBSoN32QVZWlQwIixHUMN%2Fimage.png?alt=media\&token=9ec3aef4-19b1-4992-bf4d-bf5882cf2bf7)

You may assign the **cost and price to be zer**o, because you may change it on the fly in Shopify. What’s important here is the product’s **stock number**.

### Step 2:

**Copy the stock number of your Shipping product** and paste it onto the **Shipping Fee Stock No** field in the Shopify Integration page in Imonggo’s Settings.

<figure><img src="https://165425539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEs38dWrxK8azcF755B5b%2Fuploads%2FYgIGB0HbIZt95pL1q1bH%2Fimage.png?alt=media&#x26;token=24caea48-7cdb-4109-99cd-9f2eafb91975" alt=""><figcaption></figcaption></figure>

### Step 3:

Then click the **Save** button to finalize the integration between your Imonggo account and Shopify.

**That’s it!** You may now use Shopify with Imonggo.
{% endtab %}
{% endtabs %}
