Mirakl as a Channel
Summary
Mirakl is a marketplace platform that many major retailers (Best Buy, Lowe's, Kohl's, Macy's and others) use to run their seller marketplaces. Flxpoint connects to a retailer's Mirakl instance with an API Key and Base URL and supports Sync & Link Listings, Publish Listings, Get Orders, and Sync Orders. Because each retailer runs its own independent Mirakl instance, you create a separate Flxpoint channel connection for each marketplace you sell on.
Go to Sales Channels and click + Add Channel to open the Channel Wizard. Choose Mirakl, name the channel, and select the processes you want (Sync Listings, Publish Listings, Get Orders, Sync Orders). In the Connect Channel step enter the values below, then click Test Connection → Save Connection and finish with Confirm Integrations.
| Field | What to enter |
|---|---|
Connection NameSetting | A label for this connection inside Flxpoint (e.g. Best Buy Mirakl). Use the retailer name so it is clear which marketplace this channel connects to.
For your own reference only: it is not sent to Mirakl. |
API KeyRequired | The API key generated in the seller/supplier portal of the specific retailer marketplace you are integrating with (e.g. Best Buy's seller portal, Lowe's supplier portal), not from Mirakl's own website.
Generated in your seller account settings on the retailer's Mirakl portal. |
Base URLRequired | The API endpoint for that retailer's Mirakl instance, e.g.
Specific to the retailer's Mirakl instance; each retailer has a different Base URL.https://bestbuy.mirakl.net. Enter the full HTTPS URL with no trailing path. |
Each Mirakl-powered retailer requires a separate channel connection
Mirakl is an underlying platform: Best Buy, Lowe's, Kohl's and Macy's each operate their own independent Mirakl marketplace with a unique Base URL and API Key. Create a separate Flxpoint channel for each retailer marketplace you sell on. A single Mirakl connection cannot cover multiple retailer storefronts, and products published to one retailer's instance are not visible on another's.
The API Key comes from the retailer's Mirakl seller portal, not from Mirakl directly
Your API Key is generated in the seller/supplier portal of the specific retailer marketplace (e.g. Best Buy's seller portal, Lowe's supplier portal). The Base URL is also specific to that retailer's Mirakl instance. Contact your retailer account manager or marketplace onboarding team if you cannot locate these credentials.
Mirakl Connect and Mirakl Direct are different: Flxpoint uses Mirakl Direct
Some retailers use Mirakl Connect (a separate app-based integration layer) rather than a standard Mirakl Direct API connection. The Flxpoint Mirakl channel uses the Mirakl Direct API. Many retailers on Mirakl Connect still expose a Direct API endpoint; if your retailer requires Mirakl Connect specifically, confirm with Flxpoint support whether your configuration is compatible before connecting.
Sync Orders needs Carrier and Tracking Number mapped for tracking to reach the retailer
For shipment tracking to update in the retailer's Mirakl marketplace, Sync Orders must be configured and the Carrier and Tracking Number fields must be mapped in the Sync Orders template. If these fields are missing, orders stay in an unshipped state in the retailer portal, which can trigger late-shipment notices. Verify your Sync Orders mapping before the first live order.
Creates new offer listings on the retailer's Mirakl marketplace
Syncs price, quantity and status to the retailer's Mirakl catalog for linked offers
Imports orders from the retailer's Mirakl marketplace into Flxpoint
WAITING_ACCEPTANCE, others use SHIPPING). Confirm the date-range window covers the orders you expect.Pushes shipment tracking back to the retailer's Mirakl marketplace
Connection test fails: invalid API Key or Base URL
https://bestbuy.mirakl.net) with no trailing path, and the API Key must belong to your active seller account on that marketplace. Regenerate the API Key in the retailer portal if you are unsure it is still valid.Publish listing stuck or unable to publish to the Mirakl marketplace
Sync Orders not pushing tracking: order remains unshipped in the retailer portal
Items publishing to the wrong product or appearing incorrectly on the marketplace
Orders not importing from Mirakl into Flxpoint
WAITING_ACCEPTANCE vs SHIPPING). If the connection is valid and the job runs without errors but returns nothing, confirm orders exist in the seller portal and that the date-range window covers them.Get Orders fails: "Mirakl API unavailable due to Cloudflare DNS error (error 1016)"
owner_action_required: true and retryable: false, meaning retrying the job will not resolve it. This is not a Flxpoint connection issue; the retailer (or whoever manages their Mirakl domain's DNS/Cloudflare setup) needs to fix it before Get Orders can succeed again.Listing shows as Published in Flxpoint but does not appear on the marketplace
Where do I get the API Key and Base URL to connect a Mirakl channel?
https://bestbuy.mirakl.net) and the API Key is generated in your seller account settings. Contact your retailer account manager or onboarding team if you cannot locate them.