Shopify

Last updated: July 13, 2026

Unwrap integrates with Shopify to pull in customer, order, and product data from your store. This integration requires creating a custom app in your Shopify Admin to generate API credentials then sharing these credentials with Unwrap.

Prerequisites

  • You must be the store owner or have a staff/collaborator account with the Develop apps permission

  • Admin access to enable custom app development in your Shopify store

Step 1: Create an App within the Shopify Dev Dashboard

From partners.shopify.com, open the Dev Dashboard from the left sidebar. You can also go directly to shopify.dev and sign in with your Partner account.

1. Go to Apps and click Create app

2. Enter an App name (e.g., "Unwrap Integration")

3. Choose manual configuration (skip Shopify CLI)

4. Click Create app

 

Step 2: Configure API Scopes

After creating the app, you need to assign the required API scopes.

  1. Click Configure Admin API scopes

  2. In the Admin API access scopes section, search for and select the following scopes:

  • read_customers

  • read_orders

  • read_all_orders

  • read_product_feeds

  • read_product_listings

  • read_products-read_orders

Step 3: Install the App and Get Your Admin API Access Token

Complete the following steps to install your app on a store:

  1. From your app, select Home in the left-panel of the Dev Dashboard.

  2. Scroll down and select Install app.

  3. Select or create the store for your app.

  4. Select Install.

Step 4: Authenticate your app

To make API requests, your app needs an access token. If you're building apps for your own store, you can use the client credentials grant:

  1. From your app in the Dev Dashboard, select Settings.

  2. Copy your Client ID and Client secret.

Caution The Admin API access token is only displayed once. Make sure to copy it immediately and store it securely before navigating away from this page. If you lose the token, you'll need to uninstall and reinstall the app to generate a new one.

Step 5: Submit Your Access Token to Unwrap

  1. Navigate to app.unwrap.ai/secrets

  2. Enter a Secret Name to identify this integration (e.g., your_company_name_shopify)

  3. In the Secret Value field, paste in the Client ID and Client Secret as comma separated values:

Unwrap Secrets Page

Info: Your credentials are encrypted and written directly to AWS Secrets Manager. Unwrap never stores your API tokens in plain text.

Once you've submitted your credentials, contact your Unwrap representative or email contact@unwrap.ai to complete the integration setup. Data ingestion and analysis will begin shortly after configuration is complete.