Docs
Connections

Shopify

Connect a Shopify store with a Dev Dashboard app or an existing Admin API token, choose read scopes, and read orders, customers, products and inventory.

A Shopify connection reads one store through Shopify's GraphQL Admin API. Xentropy sends only its own read queries, never mutations, and you choose the resources and fields to read. You never write GraphQL.

Availability

Shopify is not yet generally available on xentropy.ai. Contact support@xentropy.ai to request access. Until it is enabled for your account, it does not appear in the catalogue and its reads fail with PROVIDER_DISABLED.

Choose how Xentropy signs in

ModeUse it whenWhat you paste
App client credentials (recommended)You can create an app in the Shopify Dev Dashboard of the organization that owns the storeClient ID and client secret. Xentropy mints a 24-hour token from them and renews it itself
Admin API tokenThe store already has a custom app made in the Shopify adminThe app's Admin API access token (starts with shpat_)

Shopify no longer lets merchants create new custom apps in the Shopify admin, so new setups use the Dev Dashboard. Existing custom-app tokens keep working.

Create a Dev Dashboard app (client credentials)

The client credentials grant only works when the app and the store belong to the same Shopify organization. A development store made from the Shopify admin is not part of the organization: create development stores from the Dev Dashboard instead.

Sign in to the Shopify Dev Dashboard with the organization that owns the store, and create an app.
In the app's configuration, add the Admin API read scopes from the table below. Add only read_* scopes.
If you want customer contact fields, request access to protected customer data (name, email, phone, address) for the app. Skip this if you do not need them.
Release the configuration and install the app on the store.
Copy the app's Client ID and Client secret from its settings.

Or use an existing Admin API token

In the Shopify admin, open Settings → Apps and sales channels → Develop apps, choose your existing custom app, and check that its Admin API scopes include the read scopes below. Copy the Admin API access token.

Required scopes

Grant the scopes for the resources you want to read. The form lists them with a copy button, and Test connection reports any that are missing.

ScopeUnlocksRequired
read_ordersOrders and order line itemsFor orders
read_all_ordersOrders older than 60 daysOptional
read_customersCustomers (contact fields are protected customer data)For customers
read_productsProducts and variantsFor products
read_inventoryInventory levelsFor inventory
read_locationsInventory locationsFor inventory

Without read_all_orders, Shopify returns only orders created in the last 60 days. The test shows a note when the scope is missing, and reads of orders and line items stop at that 60-day window. A Dev Dashboard app in your own organization does not need Shopify's approval for read_all_orders.

If the app also has write_* scopes, the test shows a note. Xentropy never writes, but remove them from the app if you can.

Set up the connection

Open Connections, choose New connection, then Shopify.
Enter the shop's myshopify.com domain, for example your-shop.myshopify.com. Custom domains are refused.
Choose the sign-in mode and paste the client ID and secret, or the Admin API token.
Choose Test connection. The stages are dns, tls, auth and permissions. The test lists the granted scopes and any notes.
Choose Save connection. Then open the connection's resources, pick a resource and its fields, preview 100 rows and save a dataset.

Shopify needs no IP allowlist: Xentropy connects only to your shop's myshopify.com address.

Resources

ResourceOne row perScopes
OrdersOrderread_orders
Order line itemsLine item (with its order id)read_orders
CustomersCustomerread_customers
ProductsProductread_products
Product variantsVariantread_products
Inventory levelsInventory item at a locationread_inventory, read_locations

Money amounts are exact decimals with a separate currency code field. Dates are UTC datetimes. Shopify ids such as gid://shopify/Order/123 are text. Lists such as tags are a JSON list, or comma-separated text if you choose that.

Personal data

Customer name, email, phone and address, and the email and phone on orders, are personal data (Shopify calls them protected customer data). They are marked Personal data in the field picker and are off by default.

  • If you select one, the dataset is marked as containing personal data (containsPii). The API and agents must confirm this with containsPii: true, otherwise the selection is refused.
  • The app must have protected customer data access, otherwise Shopify refuses the fields.

Limits

LimitValue
Rows per read50,000
Fields per dataset100
Pages per readFree 100, Pro 600 (up to 250 rows per page)
Query cost per page250 Shopify cost points
Read deadline30 s interactive, 300 s scheduled
  • Line items are read with their orders. An order with more line items than fit on one page needs extra requests, and each counts as a page against the plan budget. Orders with many line items use the budget faster.
  • Shopify stops one listing at 25,000 records. Xentropy reads orders in created_at windows below that, so large stores are still read completely. If more than 50,000 orders match, the read fails with LIMIT_EXCEEDED: add a date filter.
  • Xentropy follows Shopify's cost-based rate limit and waits for capacity when the wait fits the deadline.
  • Xentropy uses a pinned Shopify API version. If Shopify answers with another version, the capture carries an API_VERSION_MISMATCH warning.

Errors

CodeCauseWhat to do
PROVIDER_ACCESS_DENIED, stage authThe token or client secret was rejected, or the app is not in the store's organizationCheck the credentials. For client credentials, create the app in the Dev Dashboard of the organization that owns the store
PROVIDER_ACCESS_DENIED, stage permissionsA required scope is missing. details.missingScopes names itAdd the scope to the app, release, and test again
PROVIDER_ACCESS_DENIED, stage lockedShopify has locked the storeUnlock it in Shopify
PROVIDER_PLAN_REQUIREDThe store is frozen or needs a paid plan for this dataResolve it in Shopify
RATE_LIMITEDShopify's rate limit did not recover in time. details.retryAt says when to retryRetry after retryAt
LIMIT_EXCEEDEDToo many rows, pages or fields, or a query too expensiveAdd a date filter, or select fewer fields
INCOMPLETE_DATAShopify returned partial data with errors, or paging could not be proven completeRetry later. Nothing partial is kept
VALIDATION_FAILEDThe shop domain or a selected field is invalid, or personal data was selected without containsPiiFix the input

On this page