Mirakl Integration Setup

📋Before You Start

• Approved Mirakl seller account on at least one Mirakl-powered marketplace
• Mirakl API key from the Mirakl Operator (provided by each marketplace operator separately)
• Mirakl instance URL (unique to each marketplace operator, e.g., Zalando, Macy's etc.)

🔧Setup Steps

1. 1
   Obtain your Mirakl API key

   Each Mirakl-powered marketplace has its own operator portal. Log into the seller portal for your marketplace (e.g., Zalando Seller Program, Macy's Marketplace Portal). Navigate to Account Settings → API → API Keys (exact path varies by operator). Generate or copy your API key.
2. 2
   Find your Mirakl instance URL

   Your Mirakl instance URL is specific to each marketplace operator. It typically looks like: https://marketplace.operator-name.com/api. This URL is provided in your seller onboarding documentation. If you are unsure, contact the marketplace operator's seller support.
3. 3
   Add a Mirakl connection in Pythias

   In Pythias, go to Admin → Integrations → Add New Integration → Mirakl. Enter: Instance URL (your marketplace's Mirakl API endpoint) and API Key. Give this connection a label (e.g., "Zalando Mirakl"). Click Test Connection and then Save.
4. 4
   Add additional Mirakl channels

   If you sell on multiple Mirakl-powered marketplaces (e.g., both Zalando and Macy's), each has its own separate Mirakl API key and instance URL. Repeat Step 3 for each marketplace, creating a new connection entry for each. All connections will feed into the same Pythias order queue with the marketplace name clearly labeled.
5. 5
   Map Mirakl shop SKUs

   Mirakl uses the operator's own product ID system (EAN, MPN, or operator-specific codes). In Admin → Edit Data → SKU Routing, map each Mirakl product code to your Pythias product SKU so production routing works correctly.

🔄What Gets Synced

• ✓New orders from all connected Mirakl-powered channels (polled every 10 minutes per channel)
• ✓Order line items, Mirakl offer SKUs, quantities, and buyer shipping address
• ✓Order acceptance confirmation
• ✓Shipment tracking confirmation pushed to each Mirakl channel
• ✓Order fulfillment status update

💡Tips & Troubleshooting

• ⚡Each Mirakl-powered marketplace has its own seller standing and compliance metrics — monitor each channel's performance dashboard separately.
• ⚡Mirakl API keys are usually long-lived, but some operators rotate them periodically. If orders stop pulling for a specific channel, verify the API key in that marketplace's portal.
• ⚡Use the Pythias order label field to distinguish which Mirakl channel each order came from (e.g., "Zalando", "Macy's").
• ⚡Some Mirakl operators require specific shipping carrier codes — check with each operator's seller documentation for their accepted carrier list.