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
| Mode | Use it when | What you paste |
|---|---|---|
| App client credentials (recommended) | You can create an app in the Shopify Dev Dashboard of the organization that owns the store | Client ID and client secret. Xentropy mints a 24-hour token from them and renews it itself |
| Admin API token | The store already has a custom app made in the Shopify admin | The 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.
read_* scopes.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.
| Scope | Unlocks | Required |
|---|---|---|
read_orders | Orders and order line items | For orders |
read_all_orders | Orders older than 60 days | Optional |
read_customers | Customers (contact fields are protected customer data) | For customers |
read_products | Products and variants | For products |
read_inventory | Inventory levels | For inventory |
read_locations | Inventory locations | For 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
myshopify.com domain, for example your-shop.myshopify.com. Custom domains are refused.dns, tls, auth and permissions. The test lists the granted scopes and any notes.Shopify needs no IP allowlist: Xentropy connects only to your shop's
myshopify.com address.
Resources
| Resource | One row per | Scopes |
|---|---|---|
| Orders | Order | read_orders |
| Order line items | Line item (with its order id) | read_orders |
| Customers | Customer | read_customers |
| Products | Product | read_products |
| Product variants | Variant | read_products |
| Inventory levels | Inventory item at a location | read_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 withcontainsPii: true, otherwise the selection is refused. - The app must have protected customer data access, otherwise Shopify refuses the fields.
Limits
| Limit | Value |
|---|---|
| Rows per read | 50,000 |
| Fields per dataset | 100 |
| Pages per read | Free 100, Pro 600 (up to 250 rows per page) |
| Query cost per page | 250 Shopify cost points |
| Read deadline | 30 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_atwindows below that, so large stores are still read completely. If more than 50,000 orders match, the read fails withLIMIT_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_MISMATCHwarning.
Errors
| Code | Cause | What to do |
|---|---|---|
PROVIDER_ACCESS_DENIED, stage auth | The token or client secret was rejected, or the app is not in the store's organization | Check the credentials. For client credentials, create the app in the Dev Dashboard of the organization that owns the store |
PROVIDER_ACCESS_DENIED, stage permissions | A required scope is missing. details.missingScopes names it | Add the scope to the app, release, and test again |
PROVIDER_ACCESS_DENIED, stage locked | Shopify has locked the store | Unlock it in Shopify |
PROVIDER_PLAN_REQUIRED | The store is frozen or needs a paid plan for this data | Resolve it in Shopify |
RATE_LIMITED | Shopify's rate limit did not recover in time. details.retryAt says when to retry | Retry after retryAt |
LIMIT_EXCEEDED | Too many rows, pages or fields, or a query too expensive | Add a date filter, or select fewer fields |
INCOMPLETE_DATA | Shopify returned partial data with errors, or paging could not be proven complete | Retry later. Nothing partial is kept |
VALIDATION_FAILED | The shop domain or a selected field is invalid, or personal data was selected without containsPii | Fix the input |
Notion
Create a read-only Notion connection, share databases with it, and read data source rows as datasets, with Notion's limits and personal data rules.
OpenAPI
Import an OpenAPI 3.0, 3.1 or 3.2 specification, bind GET operations with pagination and field selection, and use the GitHub, Stripe and Docker Hub presets.