Connecting a Custom Shopify App

Keith Weaver Updated by Keith Weaver

Connecting Shopify to Convictional Using Custom Credentials

This guide walks through how to connect Convictional with Shopify. Feel free to follow along with this Loom recording as well! Loom: Connecting Convictional to Shopify

Creating a Custom Shopify App

Create a custom app in Shopify to retrieve an access token to connect your store:

  1. On your stores admin page click the "Apps" menu on the bottom of the left sidebar
  2. Click "App and sales channel settings" in the popup.
  1. Click on the "Develop Apps" button on the top of the screen.
  1. Click the "Create an app" button
  1. Fill in the app name. This can be whatever you wish.
  2. Add an email address for Shopify to reach out if there is issues. We recommend that this should be the same email address as the main administrator for your store.
  3. Click "Create app" which closes the modal.
  4. Click the "Configure Admin API scopes" which will take you to the "Configuration" tab.
  1. Set up permissions that are needed to integrate with your store. Make sure you select the following scopes:
    1. write_fulfillments, read_fulfillments
    2. write_inventory, read_inventory
    3. write_locations, read_locations
    4. write_orders, read_orders
    5. write_products, read_products
  2. Click "Save" in the top right corner to save your progress.

  1. Click on the "API Credentials" tab in the top navigation bar.
  2. Click "Install app" in the 'Access tokens' box or at the top right of the screen.
  1. Confirm the installation by clicking the green "Install" button in the bottom right of the pop up
You can only view your access token once so make sure you copy it to a safe spot that you can access later before leaving or reloading the page!
  1. Click the "Reveal token once" link
  2. Copy the revealed access token to a safe spot for later. We'll will add that token to your Convictional account later.

Adding the token to your Convictional Account

Open Convictional to complete the next steps:

  1. Go to "Settings" by clicking the Settings button in the bottom left of the screen.
  2. Select the "Integrations" tab on the right side of the settings modal.
  3. You should see a blue "Re-Connect Shopify" button. Hold this button down for 3 seconds. It should slowly fill with a blue progress bar while you're holding the mouse button.

  1. This will unlock an additional "Override Token" button.
  2. Click the red "Override Token" button to unlock the "Shopify Access Token" input field.
  3. Paste the access token from step # here and click "Save".

How did we do?