Skip to main content
Markifact connects to your Shopify store using Private Apps created through Shopify’s Developer Dashboard. This guide walks you through the setup process.

​
About Private Apps

Private apps are secure, store-specific applications that you create and control. They:
  • Are installed only on your specific store
  • Give you full control over permissions
  • Can be disconnected at any time
  • Keep your data access private and secure
Why Private Apps? We initially built Shopify OAuth integration for seamless one-click connection. However, Shopify requires OAuth apps to use their billing system, which doesn’t align with our existing subscription model. Private apps give you the same functionality with full control over your store’s data access.

​
Already Have a Custom App?

If you created a custom app before January 1, 2026, it will continue to work. You don’t need to make any changes — your existing connection remains fully functional.

​
Creating a Private App

Here’s how the connection process works:
  1. Create a private app in Shopify’s Developer Dashboard — this app is exclusive to your store
  2. Configure permissions (scopes) for what data the app can access
  3. Install the app on your store using a private install link
  4. Copy your credentials (Client ID and Client Secret) from the dashboard
  5. Connect in Markifact — we securely store your credentials and verify the connection
1

Open the Developer Dashboard

  1. Login in Shopify admin then go to dev.shopify.com/dashboard
  2. Click “Create app” in the top-right corner Create App Button
2

Name Your App

  1. Under “Start from Dev Dashboard”, enter a name for your app (e.g., “Markifact Integration”)
  2. App names can be up to 30 characters
  3. Click “Create” Name Your App
3

Configure API Scopes

After creating the app, you’ll be prompted to create a version. Click on it to open the configuration page. Under the “Access” section, you need to add the required API scopes (permissions).
All scopes are required. Make sure to add all three scopes listed below.
ScopePurpose
read_ordersAccess order data for sales reporting
read_customersAccess customer data for analytics
read_inventoryAccess inventory levels and product data
To add scopes:Copy and paste the following scopes into the text box:
read_orders, read_customers, read_inventory
Alternatively, click “Select Scopes”, check the boxes next to each required scope, and click “Done”.Select Scopes
4

Release the App

  1. Click the “Release” button in the top-right corner
  2. Optionally, enter a version name and message
  3. Click “Release” to confirm
After releasing, you’ll see your version listed in the Versions page.Version Released
5

Set Up Distribution

Before installing, you need to configure the app for private distribution to your store.
  1. In the Developer Dashboard, click “Distribution” in the sidebar (or click “Select distribution method”)
Can’t find Distribution? No problem. Click “Install app” and install it on your store. You can skip the distribution step entirely and continue to the next step.
Select Distribution2. Select “Custom distribution” and click “Select”, then confirm by clicking “Select custom distribution”Select Distribution
  1. Enter your Store domain (e.g., your-store.myshopify.com)
  2. If you have multiple stores under a Shopify Plus organization, check “Allow multi-store install for one Plus organization”
  3. Click “Generate link” and confirm Generate Install Link
  4. Copy the Install link — you’ll use this to install the app on your store Copy Install Link
6

Install the App

  1. Open the Install link you copied in the previous step
  2. Select your store if prompted
  3. Review the permissions — you’ll see the app is exclusive to your store
  4. Click “Install” Install App
Once installed, the app will appear in the left-side menu of your Shopify admin.
7

Get Your Credentials

After installation, you need to retrieve your Client ID and Client Secret from the Developer Dashboard.
  1. Go back to dev.shopify.com and select your app
  2. Click “Settings” in the left sidebar
  3. Under “Credentials”, click the copy icon next to Client ID
  4. Click the copy icon next to Secret to copy your Client Secret App Credentials
Important: Keep these credentials secure. Anyone with your Client ID and Secret can access your store data.
8

Connect to Markifact

  1. In Markifact, go to the Connections page
  2. Click “Connect Shopify”
  3. Enter your Store URL or ID (e.g., your-store or your-store.myshopify.com)
  4. Paste your Client ID
  5. Paste your Client Secret
  6. Click “Connect Shopify” Connect to Markifact

​
Disconnecting Your Store

You can disconnect your Shopify store at any time: From Markifact:
  1. Go to Connections
  2. Find your Shopify connection
  3. Click “Disconnect”
From Shopify:
  1. Go to Settings → Apps and sales channels
  2. Find your Markifact integration app
  3. Click “Delete app”

​
Troubleshooting

Ensure you copied the Client ID and Client Secret correctly from the Developer Dashboard under Settings → Credentials. If you rotated your secret, make sure to update it in Markifact as well.
Verify that all required scopes are added to your app:
  • read_orders
  • read_customers
  • read_inventory
After adding missing scopes, you need to release a new version and reinstall the app for changes to take effect.
Check that your store URL is correct. It should be in the format your-store.myshopify.com (without https:// or trailing slashes).
Shopify has API rate limits. If you’re running many reports simultaneously, you may hit these limits. Try spacing out your requests or reducing the frequency of automated workflows.

​
Summary

ItemWhere to FindExample
Store URLYour Shopify store URLyour-store.myshopify.com
Client IDDev Dashboard → Settings → Credentialsc33c8418c46301ef5d95...
Client SecretDev Dashboard → Settings → Credentialsabc123def456...
Required ScopesConfigure in Dev Dashboard → Versionsread_orders, read_customers, read_inventory

Get Report

Fetch orders, customers, and inventory data from your store