Magento Integration
Overview
Section titled “Overview”The Magento integration connects MicroPIM to Magento 2 (Open Source and Adobe Commerce) using the REST API. Products, stock, prices, and categories flow from MicroPIM to Magento.
Prerequisites
Section titled “Prerequisites”- A running Magento 2.4+ store
- Admin access to the Magento back office
- Ability to create an Integration (System → Extensions → Integrations) or a dedicated admin user with API access
- An active MicroPIM account
What you’ll need
Section titled “What you’ll need”| Field | Where to find it |
|---|---|
| API URL | Your Magento base URL, e.g. https://store.example.com |
| API User | The integration username, or the dedicated admin user’s login |
| API Secret | The Access Token generated by the Magento Integration, or the admin user’s password (token auth is recommended) |
To generate an access token via a Magento Integration:
- In Magento admin, go to System → Extensions → Integrations → Add New Integration
- Name it
MicroPIM, enter your admin password to confirm - Open the API tab and select these resources:
Catalog,Inventory,Stores - Click Save
- Click Activate next to the integration, then Allow
- Copy the Access Token shown in the activation dialog
Caution: Tokens are tied to the Integration. If you delete or deactivate the Integration in Magento, the connection in MicroPIM will stop working.
Connect MicroPIM to Magento
Section titled “Connect MicroPIM to Magento”- In MicroPIM, go to Integrations → Add Integration
- Select Magento from the platform list
- Paste your Magento base URL into API URL (no trailing slash)
- Enter the integration name into API User
- Paste the 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 | Bidirectional | Simple, configurable, virtual, and downloadable types |
| Stock | MicroPIM → Magento | Per-source stock with multi-source inventory (MSI) support |
| Pricing | MicroPIM → Magento | Base price, special price, tier prices |
| Categories | MicroPIM → Magento | Mapped by category ID |
| Images | MicroPIM → Magento | Base, thumbnail, and gallery images |
Field mapping
Section titled “Field mapping”Default mapping covers Magento’s core attributes (sku, name, price, description, short_description, weight, status, visibility). Custom attributes can be mapped from Integrations → Edit → Field Mapping.
Troubleshooting
Section titled “Troubleshooting”401 Unauthorized — the access token is wrong, expired, or the Integration was deactivated. Regenerate and reconnect.
404 Not Found on test connection — the API URL is wrong or Magento’s REST API is disabled. The endpoint MicroPIM checks is /rest/V1/store/storeConfigs.
Products created in MicroPIM not appearing in Magento — confirm the product is enabled, has visibility set to “Catalog, Search”, and is assigned to a website.
Stock not updating — verify the source code mapping under Integrations → Edit → Field Mapping matches your MSI source.
Does this work with Magento 1? No. MicroPIM supports Magento 2.4 and above.
Does this work with Adobe Commerce? Yes — both Adobe Commerce (formerly Magento Commerce) and Magento Open Source are supported.
Can I connect multiple Magento stores? Yes. For multiple store views on the same instance, configure scope mapping in the field mapping editor.
Can I roll back a sync? Syncs are not reversible, but every change is recorded in the Audit Log.