Sometimes, we will require read-only access to aspects of your Shopify store such as orders created, products, product listings. These can help us to power experiences such as Recommendations engines, with data sets that are complete.
Creating a simple integration
1. Browse into your admin area and select "Settings"
2. Select “Apps” from the menu
3. Click on “Develop apps”
4. Click on “Build apps in Dev Dashboard”
5. Click "Create app"
6. Name the app something relevant, like “WebtrendsOptimize-ShopFeed”
7. Click “Create”
8. Configure “Create version”
Set App URL to https://shopify.dev/apps/default-app-home
Uncheck Embed app in Shopify admin
Ensure Webhooks API Version is 2026-01 if using a new version let us know.
Add the following Access → Scopes:
read_customer_events,read_inventory,read_orders,read_product_listings,read_products,unauthenticated_read_product_inventory,unauthenticated_read_product_listings
Ensure Use legacy install flow is not checked
9. Click "Release" to Save
10. Head to the apps overview and click "Install app" follow the prompts and install on your store.
11. Head back to the apps overview page on dev dashboard and click on settings and share with us the:
Client ID
Secret
Default Shopify URL e.g. https://your-store-name.myshopify.com
That’s it. We’ll now be able to read your orders, and understand which products are popular, which are bought together, etc. in full.
Shopify Partner Stores
If your store was built as a Shopify Partner, there is some additional steps to complete setup; In order to verify permissions for read_orders.
1. Open your partners dashboard and select App Distribution → All apps.
2. Select the newly created app from the previous steps.
3. Select "API access requests" and find the "Protected customer data access" card and click "request access".
4. Under protected customer data select personalisation and save.
Permissions Explained
To explain why we suggest these fields:
Permission |
|
read_orders | Allows us to access read only order data from the last 60days through the admin api, to power recommendations based on previous purchases. |
read_products, read_inventory, read_product_listings | Allows us to access read only product data through the admin api, to determine which products are on the site, which categories you’ve grouped them into, and what their stock levels are – essential bits of information for creating valid recommendations. |
unauthenticated_read_product_inventory, unauthenticated_read_product_listings | Optional: Allows us to access read only product data through the storefront api. This can help power recommendations based on your configured Search & Discovery filters. |
read_customer_events | Allows us to access read only customer events data e.g. product_viewed, cart_updated. |