How to Connect Shopify to Graphed

To connect your Shopify store to Graphed for data syncing and analytics, follow the steps below to create a custom app via the Shopify Dev Dashboard and obtain the client ID and client secret. This process enables Graphed to securely access your store’s data through Shopify’s Admin API.

Requirements

• Shopify admin access (store owner or staff with app development permissions)
• The store domain (e.g., your-store-name.myshopify.com)
• A Graphed account

Step 1: Create a Custom App

1. Log in to your Shopify account.
2. Go to the Shopify Dev Dashboard.
3. On the navigation menu, click Apps and then click Create app.
4. In the Start from Dev Dashboard section, enter an App name (e.g., Graphed Integration).
5. Click Create.

Step 2: Configure API Scopes

1. Select 2025-10 as the Webhooks API version from the drop-down menu.
2. In the Scopes field under the Access section, copy and paste the following scopes:
3. read_analytics, read_assigned_fulfillment_orders, read_content, read_customers, read_discounts, read_draft_orders, read_files, read_fulfillments, read_gift_cards, read_inventory, read_locales, read_locations, read_marketing_events, read_merchant_managed_fulfillment_orders, read_orders, read_price_rules, read_product_listings, read_products, read_publications, read_reports, read_resource_feedbacks, read_returns, read_script_tags, read_shipping, read_shopify_payments_accounts, read_shopify_payments_disputes, read_shopify_payments_payouts, read_themes, read_third_party_fulfillment_orders, read_translations
4. You can leave all other sections and fields unchanged — they are not required for building or configuring a custom app.
5. Click Release.

Step 3: Install the App

1. On the navigation menu in the Dev Dashboard, click your app name and select Home.
2. Click Install app.
3. Install the app to your store.

Step 4: Find Your Client Credentials

1. In the Dev Dashboard sidebar, click Settings.
2. In the Credentials section, copy the Client ID and Client Secret.

Step 5: Submit Your Credentials to Graphed

1. Log in to your Graphed account.
2. Go to the Create Shopify Source page.
3. Enter:
• Your Store Domain (e.g., your-store-name.myshopify.com)
• The Client ID
• The Client Secret

Request Additional API Access (Optional)

Some scopes require extra permissions. If you don’t need them, you can skip this section.

read_users scope

To use this scope, one of the following must be true:

• The app is a finance embedded app.
• The app is installed on a Shopify Plus or Advanced store.

Contact Shopify Support to enable this scope if required.

read_all_orders scope

By default, you only have access to the last 60 days of orders. To access all historical orders, you need to request access from the Shopify Partners dashboard:

1. Go to the Shopify Partners dashboard.
2. Navigate to Apps and select your app.
3. Open the API access requests section.
4. In the Read all orders section, click Request access.
5. In the justification field, specify that the app needs full read-only access to historical orders for long-term analytics, reconciliation, and reporting.
6. Submit the request and wait for Shopify approval.

After Shopify approves the request:

• Add the read_all_orders scope to your app scope list.
• Install the new app version on the target store to sync all orders.
• If the app was already installed before this permission was granted, you must uninstall and reinstall the app for the new scope to take effect.

Completion

Once submitted, Graphed will begin syncing your store’s data continuously. This will enable querying and reporting through Graphed’s AI Agent.

If you encounter any issues or have questions, please contact support@graphed.com or reach out through the Intercom messenger.