More information can be found at https://help.shopify.com/en/manual/apps/app-types/custom-apps.

Activate custom app development from the Shopify admin

Before creating a custom app for your store, you need to enable Custom App Development on your Shopify account. To do this, you need to be the store owner or a staff member with the Enable app development permission to activate custom app development. Basic plan users must upgrade to Shopify Advanced or Shopify Plus plans to configure this setting.

Follow the steps below to enable Custom App Development on your Shopify account:

  1. From your Shopify admin, click Settings>Apps and sales channels.
  2. Click Develop apps.
  3. Click Allow custom app development.
  4. Read the warning and information provided, and then click Allow custom app development.
  5. Create and install a custom app

After you've activated custom app development, you can create and install a custom app in your Shopify admin. You need to set API scopes to determine which parts of your store the custom app can access. After the app is installed, you'll receive access tokens that the app uses to access information from your store using Shopify's APIs.

The store owner, collaborators, and staff members with the relevant permissions, have the ability to create and install custom apps.

Select API scopes

After you create a custom app, you can assign API scopes to it. A custom app can have Admin API scopes, Storefront API scopes, or both, depending on the app's requirements. At least one scope must be selected prior to installing the app. 

Steps:

  1. Select Scopes.
  2. In the Admin API access scopes section, select the API scopes that you to assign to the app.
  3. For the Acadio app to work you will need to choose scopes: “read_orders,  read_products, read_customers”
    • Optional: Set the API version you want to use for webhook subscriptions.
    • Optional: You can set up Google Cloud Pub/Sub to handle webhook subscriptions for the app. In the Google Cloud Pub/Sub section, copy your Shopify service account address and use it to configure your Google Cloud Pub/Sub account.
    • Optional: You can set up Amazon EventBridge to handle webhook subscriptions for the app. In the Amazon EventBridge section, click Create source.
  4. In the Storefront API access scopes section, select the API scopes you want to assign to the app.
  5. Click Save.

Install the app and get the API access tokens

After you've set API scopes for your app, you can install the app. The API access tokens will be provided after installation. Depending on what API scopes you assign to the app, you'll get an Admin API access token, a Storefront API access token, or both.

Steps:

  1. Click Install app.
  2. In the modal window, click Install app.
  3. Get the access token:
    • If you selected Admin API scopes for the app, then go to the Admin API access token section and click Reveal token once. After revealing the full access token the first time this page is accessed, this page displays only the last 4 digits of the access token for reference on subsequent visits.
    • If you selected Storefront API scopes for the app, then you can go to the Storefront API access token section and copy your token. Unlike the Admin API access token, the Storefront API access token is always available on this page.

Activate and configure your custom app

Follow the steps below to configure and activate your custom app:

  1. Log into your Acadio admin portal at (Your-Domain).acadio.com.
  2. Click Settings on the main menu.
  3. Click Integrations.
  4. Install the Shopify app.
  5. Enter your Shopify store name (do not use your vanity URL).
  6. Enter your API access token and Secret Key.
  7. When finished, click Save.
 

IMPORTANT: To ensure your store is set up properly, we recommend creating a test order in your Shopify store. Then, in Acadio, select Shop from the main menu and click Sync Orders. The recent test order should be displayed.