Apps, data sources and Quota
For downloads to run smoothly, it is strongly recommended that you create a separate app for each data source/report type. This also ensures that each data source has dedicated quota, since quota limits are set on app level. Note that the Shopify Partner Dashboard (https://partners.shopify.com) cannot be used to create apps. Instead, apps must be created in each store, via the Shopify Store Admin interface: https://<yourshop>.myshopify.com/admin. See the steps below.
Setting up an App and copying credentials
Log in to your Shopify Store Admin interface: https://<yourshop>.myshopify.com/admin
Go to "Apps" in the menu to the left
Scroll to the bottom of the drop-down menu and select "Apps and Sales Channel Settings"
Click “Develop apps” on the top right
Click “Create an app”
Give the app an "App name" of your choice
Choose a user of your choice as "App developer"
Click "Create app"
Click “Configure Admin API scopes”
Make sure that all of the following permissions are enabled:
- read_analytics
- read_customers
- read_draft_orders
- read_marketing_events
- read_orders
- read_products
- read_inventoryPlease note that Funnel only needs read access, you should not check any checkboxes that starts with "write_..."
This is how it looks while selecting permissions:
Now click "Save"
Once you have saved and then revisit the configuration page again, for example by clicking the "Configuration" tab, your permissions should look like this:
Now click "Install app" in the top right
In the new dialogue that appears click "Install"
Shopify should bring you to the "API credentials" tab where the following three keys and tokens have been generated for you:
Admin API access token (This token can only be viewed once, please save this token in a secure place for future reference)
API key
API secret key (Should not be used for connecting your Funnel data source)
To create your Funnel data source connection you should input your "Admin API access token" (you must press "Reveal token once" before copy) and "API key" that have been generated for your app:
In addition to this we also need your shop name, which you can find in the address bar when logged into your shop (ie. https://thisismyshop.myshopify.com/admin where the shop name would be “thisismyshop”, without the rest of the URL) or in the top left corner of the administrative GUI:
Warnings from Shopify
Shopify update their APIs on a quarterly schedule, see https://shopify.dev/concepts/about-apis/versioning. In connection with this they issue warnings to their customers that an app may need to be updated, something similar to this:
"Your private apps may no longer work if not updated before..."
"App" in this context refer to the user of the credentials (API key and secret) that is created to let another service, e.g. Funnel, access the Shopify API. Typically there should be no need to take any action for a Funnel user; if needed Funnel will update the connector.