This guide explains how to create the app in your Shopify Partners account, configure API access, and request access to the complete order history. Please follow the steps in the specified order. Once the setup is complete, share the Client ID and Client secret with your EAS contact via the agreed secure channel.
1. Go to the "Dev Dashboard" from Shopify Partners main page
In Shopify Partners main page, open App distribution → All apps and click Visit Dev Dashboard.
2. Start creating the app
On the Dev Dashboard home page, click Create an app.
3. Complete the Create an app form
Enter the clear and descriptive application name in App name field. You may leave Version name blank. Enter the settings below, check them, then click Create app button.
| Parameter | Value |
|---|---|
| App URL | https://eu-vat-compliance.easproject.com |
| Allowed redirection URL(s) |
Add all 5 URLs https://eu-vat-compliance.easproject.com/auth/install |
| Embed App in Shopify Admin | Selected |
| Use legacy install flow. | Selected |
| API Access |
Add the list below to the field. read_assigned_fulfillment_orders,read_customers,read_draft_orders,read_fulfillments,read_inventory,read_locales,read_locations,read_merchant_managed_fulfillment_orders,read_orders,read_price_rules,read_products,read_returns,read_shipping,read_third_party_fulfillment_orders,write_assigned_fulfillment_orders,write_customers,write_draft_orders,write_fulfillments,write_inventory,write_merchant_managed_fulfillment_orders,write_orders,write_price_rules,write_products,write_shipping,write_third_party_fulfillment_orders |
When the form is completed, click Create app button in the upper right corner and wait for the new app page to open.
4. Using the Client ID and Client secret
In the Dev Dashboard, open the new app’s Overview page. Copy the Client ID and Client secret from Credentials on the right side. The screenshot shows example values; use the credentials of your own app.
5. Return to Shopify Partners
Open App distribution → All apps. Find the app you just created and click its name.
App list in Shopify Partners
6. Open the distribution settings
On the app page, select Distribution. You can also click Choose distribution on the Overview page.
App page with the Choose distribution button
7. Select Custom distribution
In Distribution, select Custom distribution and click Select. Confirm your choice if Shopify prompts you to do so.
Custom distribution option
You can also reach this screen through API access requests → Request additional scopes and APIs → Choose distribution.
Choose distribution link under API access requests
8. Select API access requests
After selecting the distribution method, go to API access requests on the left side menu. Under Read all orders scope, click Request access.
Access request form for orders older than 60 days
Paste the text below into Why does your app need access to orders older than 60 days? Then click Request access.
Access to read_all_orders is required to retrieve and analyze historical order data beyond Shopify's standard access period. This permission is essential for the proper development, testing, and validation of the application's functionality using real order data, including the processing of older orders.
10. Confirm that access was granted
Return to API access requests. Under Read all orders scope, you should see: “Your app can access the full order history for a store.”
Confirmation of full order history access
Use the app name, Client ID, and Client secret during configuration Dev Application in the Dashboard.
Please ensure that Custom distribution is selected and read_all_orders access has been granted.