Overview
Once Shopify is connected, the Dema Agent can query products, orders, customers, and inventory from your Shopify store through the Admin GraphQL API. Useful for pulling live commerce data into an analysis and for light write actions such as updating customer records, discounts, and product publications.Prerequisites
- A Shopify store you are the owner of, or staff access with permission to manage apps.
- Access to the Shopify Dev Dashboard to create the OAuth app.
Shopify requires you to create your own OAuth app and paste its credentials into Dema. You only need to do this once per store.
Connect Shopify
Create an app in the Shopify Dev Dashboard
- Open the Shopify Dev Dashboard and go to Apps → Create app.
- Give the app a recognizable name, for example
Dema Agent. - In App setup, add
https://app.dema.ai/agents/oauth/callbackto the Allowed redirection URL(s) list. - Save the app.
Request the scopes Dema needs
In Configuration → Access scopes, request the scopes listed under Scopes Dema requests below and save.
Paste the credentials into Dema
In Dema, go to Agents → Settings → Integrations, find Shopify, and click Connect. Enter:
- Client ID from Shopify
- Client secret from Shopify
- Account URL in the form
https://{store}.myshopify.com, replacing{store}with your store’s subdomain
Scopes Dema requests
| Scope | What it allows |
|---|---|
read_products, write_products | Read and update products and variants |
read_orders, write_orders | Read and update orders |
read_customers, write_customers | Read and update customer records and tags |
read_inventory | Read inventory levels |
read_locations | Read store locations, used for per-location inventory views |
read_publications, write_publications | Read and update product publications across sales channels |
read_discounts, write_discounts | Read and update discounts and promotions |
Troubleshooting
- Redirect URI mismatch. The redirect URI in your Shopify app must be
https://app.dema.ai/agents/oauth/callbackexactly, including protocol and path. - Dema says the store URL is invalid. The account URL must be HTTPS and must end with
.myshopify.com. Use your store’s real subdomain, not a custom domain. - Install fails on the store. The staff account installing the app must have permission to install private and custom apps. Owners can grant this from Settings → Users and permissions.