NEWStoreClaw Ranks #1 Product of the Week on Product Hunt
StoreClaw

After you connect a store, StoreClaw can read Shopify orders, inventory, products, customers, and other data within the authorized scope for analysis, reports, and scheduled tasks. This article explains how to create a Shopify custom app and complete the connection.

Why Connect a Store

After a store is connected, StoreClaw can perform tasks based on real business data:

  • Data analysis: StoreClaw generates analysis based on the orders, inventory, and traffic data you authorize.
  • Scheduled tasks: After the data source is connected, scheduled tasks can check store metrics and generate alerts on schedule.

Get Shopify API Credentials

Because of Shopify's security requirements, you need to authorize StoreClaw through a custom app. Follow the steps below to obtain the Client ID and Client Secret.

Step 1: Start App Development in Shopify Admin

  1. Sign in to Shopify Admin and go to Settings -> Apps.
  2. Click Develop apps, then click Create app in Dev Dashboard in the upper-right corner of the page. Create App
  3. Shopify automatically redirects you to the Shopify dev dashboard.

Step 2: Create an App in the Dev Dashboard

  1. In the Shopify dev dashboard, click Create app. Create App
  2. Select Start from Dev Dashboard, enter an app name, and click Create. Create App

Step 3: Configure App Permissions and Settings

  1. Continue through the app setup flow and locate App URL, then fill in the default address: https://www.storeclaw.ai/app/connectors?platform=shopify
  2. Uncheck the Embed app in Shopify checkbox. App URL
  3. In the Access scopes section, click Select scopes. permissions
  4. Select the required permission scopes and click Done.
  5. In the Access scopes section, click Select scopes. scope
  6. Select the required permission scopes and click Done.

StoreClaw can only do what you authorize. The scopes you select determine which operations StoreClaw can perform. If an action is not authorized, StoreClaw will return a permissions error when it tries to run it. Select only the scopes needed for your current tasks.

The table below shows common scopes and the capabilities they control:

Scope What StoreClaw can do when selected What it cannot do if not selected
read_orders Query orders, analyze sales trends, generate sales reports Cannot access any order data
write_orders Update order status and notes Can only view orders, not modify them
read_products Query product information and analyze product performance Cannot read product data
write_products Edit product titles, descriptions, prices, and publish status Can only view products, not edit them
read_inventory Query inventory levels and trigger restock alerts Cannot access inventory data
write_inventory Adjust inventory quantities Can only view inventory, not change it
read_analytics Read traffic, conversion, and other analytics data Cannot read Shopify built-in analytics reports
read_customers Analyze customer profiles and review customer history Cannot access customer information
read_shopify_payments_payouts Review payment and payout records Cannot access payment flow data
  1. Click Release, then click **Release **again in the confirmation dialog. Release App

Step 4: Install the App in the Store

  1. After publishing, click the app name in the left navigation to open the app details page.
  2. On the Overview page, click Install app in the upper-right corner.
  3. Select the store where you want to install the app, then click Install on the confirmation page. Install App

Note: Unless you are a Shopify Plus user, each custom app can be installed in only one store. If you need to connect multiple stores to StoreClaw, create a separate app for each store in the Shopify dev dashboard and repeat this process for each one.

Step 5: Retrieve API Credentials

  1. After the app is installed, return to the Shopify dev dashboard.
  2. Open the app details page and click Settings in the left menu.
  3. In the Credentials section, copy the Client ID and secret. Click the eye icon to reveal the secret if needed. Credentials

Complete the Configuration in StoreClaw

  1. Open Connectors: In the left navigation of StoreClaw, click Connectors, then find Shopify under the Ecommerce category.
  2. Fill in the fields:
    • Store Domain: Your store admin domain, for example your-store.myshopify.com.
    • Client ID: Paste the API key you just copied.
    • Client Secret: Paste the API secret key you just copied.
  3. Activate the connection: Click Connect Shopify ->.
  4. Verify status: After the connection succeeds, the Shopify card shows a connected status.

Connection Failed? Common Checks

If the connection does not succeed, review these common issues:

Symptom Possible cause How to fix it
Credential error The Client ID or Client Secret is incorrect Confirm that you copied the full API key and API secret key and did not include extra spaces
Permission error The scopes were not published or the app was not installed Return to the Shopify dev dashboard and confirm you completed both Publish and Install app

Common Use Cases

After the connection succeeds, you can send instructions directly to StoreClaw in chat. The examples below work only if you granted the required scopes in Step 3. If the necessary scope is missing, StoreClaw will report insufficient permissions.

Required scope Example prompt
read_orders Analyze my order trends for the past 7 days.
read_inventory Check inventory and list the products that need restocking.
read_customers Analyze my customer profile.

FAQ

Q: Will StoreClaw modify my store data?

A: That depends on the permissions you granted. If you selected only read_* scopes, StoreClaw can read data only and cannot make changes. Write actions are possible only when you also grant the corresponding write_* scopes and explicitly ask StoreClaw to perform those actions.

Q: Shopify is connected, but StoreClaw says it cannot access permissions in chat. What should I check?

A: Confirm the following:

  • You authorized the correct store.
  • The store actually contains data. For example, a newly created store may not have historical orders yet.
  • The authorization scope is complete. Some platforms let you check scopes manually during authorization, so make sure the scopes required by StoreClaw are selected.

Q: How do I disconnect the store?

A: On the Connectors page, click the connected card and select Disconnect. It is also a good idea to uninstall the corresponding custom app in Shopify Admin to ensure access is fully revoked.