Shopify Integration
Overview
Section titled “Overview”The Shopify integration connects MicroPIM to one or more Shopify stores using the Admin API. Product data, stock levels, and prices flow from MicroPIM to Shopify. You can run multiple Shopify connections in parallel — one per store — and assign each to a different Publishing Channel.
Prerequisites
Section titled “Prerequisites”- An active Shopify store on any paid plan
- Admin access to the Shopify store
- Permission to install a Custom App from the Shopify admin
- An active MicroPIM account
What you’ll need
Section titled “What you’ll need”| Field | Where to find it |
|---|---|
| API URL | Your Shopify store URL: https://your-store.myshopify.com |
| API User | The Custom App name (any label you choose in Shopify) |
| API Secret | The Admin API access token generated when you install the Custom App |
To generate the access token:
- In Shopify admin, go to Settings → Apps and sales channels → Develop apps
- Click Create an app, give it a name like
MicroPIM - Click Configure Admin API scopes and enable:
read_products,write_products,read_inventory,write_inventory,read_product_listings - Click Save, then Install app
- Copy the Admin API access token (shown only once)
Caution: The Admin API access token is shown only once. Store it securely — if you lose it, you’ll need to uninstall and recreate the Custom App.
Connect MicroPIM to Shopify
Section titled “Connect MicroPIM to Shopify”- In MicroPIM, go to Integrations → Add Integration
- Select Shopify from the platform list
- Paste your store URL into API URL
- Enter the Custom App name into API User
- Paste the Admin API access token into API Secret
- Click Test Connection to verify
- Click Save to create the integration
What syncs
Section titled “What syncs”| Data | Direction | Notes |
|---|---|---|
| Products | MicroPIM → Shopify | Title, description, vendor, type, tags, variants |
| Stock | MicroPIM → Shopify | Per-location inventory levels |
| Pricing | MicroPIM → Shopify | Base price and compare-at price |
| Categories | MicroPIM → Shopify | Mapped to Shopify collections |
| Images | MicroPIM → Shopify | Up to 250 per product |
Field mapping
Section titled “Field mapping”A default mapping is applied automatically when you create the integration. To customize it, go to Integrations → Edit → Field Mapping and map each MicroPIM attribute to the corresponding Shopify field or metafield.
Troubleshooting
Section titled “Troubleshooting”401 Unauthorized when testing the connection — the access token is wrong or the Custom App was uninstalled. Regenerate the token and reconnect.
403 Forbidden on product updates — the Custom App is missing the write_products scope. Edit the app scopes in Shopify and reinstall.
Rate limit errors — Shopify’s Admin API limits requests per app. MicroPIM retries automatically with backoff; large initial syncs may take several minutes.
Products created in MicroPIM not appearing in Shopify — confirm the product is published and assigned to the Shopify-mapped publishing channel.
Can I connect multiple Shopify stores? Yes — add one Shopify integration per store. Assign each to a different Publishing Channel.
Does this work with Shopify Plus? Yes, the Admin API is the same across all Shopify plans.
How often does the sync run? On-demand from the Integrations page, or on a schedule you configure under Automation.
Can I roll back a sync? Syncs are not reversible, but every change is recorded in the Audit Log.