Creating a Shopify app

Any connection between Shopify and another software, like Perkville, requires an app to facilitate this connection. To connect your Shopify store with Perkville you will need to create a custom app for your store. To do this, follow the steps below:

1. Within in your Shopify store lick Apps in the left-hand navigation bar in your store or search for “Apps” in the search bar

2. Click Develop apps to the left of “Shopify App Store” or click Developer apps for your store under “Build custom apps for your unique needs”

3. If you haven’t already, you’ll need to click Allow custom app development

4. Once you’ve reviewed and agreed to Shopify’s disclaimer you should be able to click to Create an app

5. This will bring up a pop-up to begin creating your custom app. We suggest naming the app “Perkville Custom - YOUR STORE NAME”

6. Set the developer as yourself

7. Congratulations! You have created an app. Now, you’ll need to click to Configure the Admin API Scopes. Your app’s admin API scopes determine what data your app will be allowed to access or what actions your app will be able to perform in Shopify. Essentially, you’re setting up what will be allowed to go through your app. You can search for the scope you’d like to allow for your custom app

8. You will need to enable the following scopes:

   • read_products

   • read_orders

   • read_customers

   • read_locations

   • read_shopify_payments_payouts

You can search for the scope you’d like to allow for your custom app

1. You can ignore the other settings on this page, like webhook subscriptions, etc. Go ahead and click Save.

2. Next, you’ll need to get your app’s credentials. To do this, go to API credentials in the menu at the top of the page.

3. You’ll then need to download the app to your store. Go ahead and click to do this.

4. You should then see three credentials: “Admin API access token,” “API key and secret,” and your access token. The Perkville team will need all three of these credentials along with your “Shopify store name”. Go ahead and copy these and provide them to the Perkville team in a secure way. We suggest using OneTimeSecret.

5. Provide your Perkville rep. with your custom app’s token, API key, secret key, and Shopify store name

6. Once you’ve provided the Perkville team with these credentials, they’ll take the lead on getting your store connected.

7. Repeat the above steps for any of your other stores.