This guide creates the Shopify custom app you need to connect Shopify to Acenda as a Fulfillment Provider — the setup where Acenda sends your orders to Shopify for fulfillment. Since January 1, 2026, Shopify retired the old private-app "API Key and Password" screen, so every new connection now starts with a custom app in Shopify’s Dev Dashboard, which gives you a Client ID and Secret to enter in Acenda instead.
This Client ID and Secret are used by the Shopify Fulfillment Provider integration only. If you’re connecting Shopify as a Sales Channel instead (selling storefront orders into Acenda), that connection goes through Shopify’s own install screen and never asks you for a Client ID or Secret — see Connecting Sales Channels: How to Integrate with Acenda. For the rest of the Fulfillment Provider setup around this app, see Acenda and Shopify Integration: Step-by-Step Guide — come back here for Phase 1, then return there to finish.
Before you start: You’ll need admin access to your Shopify store to create and install the app. If you don’t see Develop apps in Shopify, or Shopify won’t let you create one, see Troubleshooting below.
Phase 1: Create the Acenda Custom App in Shopify
Step 1: Open Shopify App Development
Log in to your Shopify Admin.
In the left sidebar, click Settings (gear icon).
Go to Apps and sales channels.
Click Develop apps (top right).
Click Build apps in Dev Dashboard.
Tip: If this is your first custom app, Shopify may prompt you to Allow custom app development. Confirm to continue.
Step 2: Create the App
In the Dev Dashboard, click Create app.
Enter an app name (Recommended:
Acenda).Click Create. You are now inside the app workspace.
Step 3: Configure API Scopes (Permissions)
In the left-hand menu, open Access settings (or Configuration).
Locate the Scopes field.
Copy and paste the full list below directly into the field:
read_all_orders, read_orders, write_orders, read_customers, write_customers, read_products, write_products, read_inventory, write_inventory, read_locations, write_locations, read_fulfillments, write_fulfillments, read_assigned_fulfillment_orders, write_assigned_fulfillment_orders, read_merchant_managed_fulfillment_orders, write_merchant_managed_fulfillment_orders, read_returns, write_returns, read_reports, write_reports
Tip: You can optionally give the version a name (for example, "Initial Acenda Sync"), but it’s not required.
Phase 2: Install the App on Your Store
Step 4: Install the App
In the Dev Dashboard sidebar, click Home under your Acenda app.
Click Install app.
If you manage multiple Shopify stores, select the correct store from the list.
Review the permissions screen and click the black Install button.
Phase 3: Connect Shopify to Acenda
Step 5: Find Your Shopify Store Name (Handle)
Return to your main Shopify Admin.
Go to Settings > Domains.
Locate the domain ending in
.myshopify.com.Copy only the text appearing before
.myshopify.com.Example: if your domain is
my-store.myshopify.com, copymy-store.
Step 6: Add the Integration in Acenda
In the Acenda sidebar, under CHANNELS, click Integrations.
Click Edit next to your Shopify Fulfillment Provider integration (or + New if you haven’t added it yet — see Acenda and Shopify Integration: Step-by-Step Guide for that first step).
Open the Authorization tab.
Paste the subdomain from Step 5 into Shopify Store Name.
Step 7: Copy Your API Credentials
Return to the Shopify Dev Dashboard and open your Acenda app’s Settings.
Locate the Client ID and Secret, and click the copy icon next to each.
Back in Acenda’s Authorization tab, paste them in:
Client ID → Acenda’s Client ID field
Secret → Acenda’s Client Secret field
Leave the older API Key and Auth Token fields blank — those belong to Shopify’s retired private-app flow and aren’t used by custom apps.
Click Save.
Treat your Secret like a password. Don’t paste it into a support ticket, email, or chat message. If you think it’s been exposed, click Rotate in the Shopify Dev Dashboard to generate a new one, then update it in Acenda.
Troubleshooting
Don’t see "Develop apps" in Shopify, or Shopify won’t let you create a custom app: custom app development may need to be allowed for the store first (see the Tip in Step 1), or you may need store owner permissions — ask your Shopify store owner to enable it or create the app.
Acenda can’t connect, or shows an authentication error after you save: double-check Shopify Store Name is the bare subdomain before
.myshopify.com— not a custom domain and not the full.myshopify.comaddress. Also confirm the app was Released (Step 3) and Installed (Step 4); a saved-but-uninstalled app can look connected in Acenda but fails on the first real call.Connected, but one feature doesn’t work (for example, something touching orders, inventory, or returns): add the matching scope to the Scopes field from Step 3 on Shopify’s side, click Release again, and give it a few minutes to take effect.
You regenerated the Secret in Shopify: Acenda doesn’t pick up a rotated Secret automatically — copy the new one and update Acenda’s Client Secret field, then Save.
🎉 Connection complete. Your Shopify store is now connected to Acenda as a Fulfillment Provider. Next, add your warehouses and set routing so Acenda knows where to ship orders from — see Adding and Managing Warehouses in Acenda.
Related articles
Still stuck? Contact Acenda Support and tell us your Shopify store name and which step you’re on.






