Connect TikTok Shop to Mirakl

Two things to know before you start:

• The app is the intermediary. There is no direct TikTok-to-Mirakl integration - data flows through Pipe17 in both directions.
• This article covers the MIRAKL MP connector (API key authentication). The app also offers a separate MIRAKL connector that uses OAuth and an environment selector - if your account uses that one, check with support before following these steps.

What syncs

On the TikTok Shop side, product, inventory, and fulfillment sync work normally - with one exception: pushing products to TikTok Shop is available only for US and UK regions. Outside those regions, maintain the TikTok Shop catalog in TikTok Shop directly.

Before you begin

Connect TikTok Shop first. See Connect TikTok to Pipe17.

Then gather the following for the Mirakl setup:

• MIRAKL MP URL for your environment.
• MIRAKL MP API Key from your Mirakl operator.
• The list of Mirakl locations you intend to use, and the 3PL or warehouse each one should map to.
• Catalog decision: Which platform will be the source of truth - Mirakl, TikTok Shop, or both already populated with matching SKUs.

For more background, see Connect Mirakl to Pipe17.

Step 1: Connect Mirakl

1. Add the MIRAKL MP connector from the connector catalog if it isn't already under Integrations.
2. Open the Mirakl settings and enter:
   • MIRAKL MP URL - your Mirakl environment URL.
   • MIRAKL MP API Key - from your Mirakl operator.
3. Save the configuration.
4. Click Connect. Mirakl authenticates with the credentials you entered - there is no OAuth redirect.
5. Confirm the integration shows as connected with no errors.

Step 2: Connect TikTok Shop

1. Open the TikTok Shop settings. Under Products → Process product catalog updates, pick the option that matches your catalog source:
   • Pull products from Tiktok to Pipe17 - TikTok Shop is the catalog source. The app then pushes the catalog out to Mirakl.
   • Push products from Pipe17 to Tiktok - another connected source (including Mirakl) feeds TikTok Shop. US and UK only.
   • Disabled - when TikTok Shop and Mirakl catalogs are maintained independently.
2. Open the Connection Details tab and click Connect to complete OAuth.
3. Confirm both integrations show as connected with no errors.

Step 3: Choose your catalog source

The catalog source determines how product data flows between the two platforms.

• Mirakl as the source. On the Mirakl connector, set Process product catalog information to Pull product catalog from MIRAKL MP. The app ingests the Mirakl catalog and can push it to TikTok Shop (US and UK only).
• TikTok Shop as the source. Set TikTok Shop to Pull products from Tiktok to Pipe17. The app then pushes the catalog out to Mirakl.
• Both already populated. When products exist on both sides, the app matches them by SKU. Identical SKUs are linked automatically.
• Another connected source. If your catalog originates from a third channel (for example, Shopify or Salesforce), connect that as the source and let it feed both TikTok Shop (US/UK only) and Mirakl.

Pick one approach before pushing or pulling product data. Switching after products exist on both sides can produce duplicates or mismatched records.

Step 4: Match products by SKU

The app uses SKU as the unique identifier for product matching across channels.

• Identical SKUs across Mirakl and TikTok Shop are linked automatically.
• Identical SKUs assigned to different products will be incorrectly merged. Audit your catalogs for SKU uniqueness before connecting them.

Map a Mirakl SKU when it differs

If a product uses a different SKU in Mirakl than in the app, map it on the product record.

1. Navigate to Products and open the product.
2. Scroll to the Channel Options section. Each connected integration appears as a row with Integration Name, Sync to Channel, Inventory Buffer, and Channel SKU columns.
3. In the Mirakl row, enter the Mirakl-specific SKU in the Channel SKU column.
4. Save your changes.

Notes:

• The Channel SKU column does not appear on the TikTok Shop row. The SKU coming in from TikTok Shop must match the app's master SKU.
• The Channel SKU column is hidden on parent products with no channel SKUs set. Open a child or variant product to set values.

Optional: scope inventory sync to specific SKUs

If you're rolling out Mirakl inventory gradually or want to exclude a subset of products, use one of these Mirakl connector settings:

• Report inventory updates only for products with specific SKUs (inventorySKUs) - allow list. Inventory updates push to Mirakl only for the SKUs you list.
• Do not process inventory information for products with specific SKUs (inventorySKUsExclude) - block list. Inventory updates skip the SKUs you list.

Use one or the other - they should not overlap.

Step 5: Set up locations

Mirakl locations are not imported by default. You must enable the location pull on the Mirakl connector first.

1. On the Mirakl connector, enable Pull locations from MIRAKL MP.
2. Save the configuration. Mirakl locations appear under Inventory → Locations.
3. Open each Mirakl-sourced location and link it to the corresponding 3PL or warehouse integration. This determines where the Order Routing Engine sends orders for that location.

If you share fulfillment infrastructure with TikTok Shop, point the matching Mirakl locations to the same 3PL or warehouse. If Mirakl uses separate fulfillment, link each location to its dedicated 3PL.

See Using Locations for more on linking locations.

Step 6: Enable sync and configure order behavior

On the Mirakl connector, enable the sync settings for orders, products, inventory, and fulfillment. Two settings affect how orders flow in:

• Mirakl order statuses to pull (ordersStatuses) - multiselect filter. By default, the app pulls orders in WAITING_ACCEPTANCE, REFUSED, and CANCELED statuses. Adjust this list if you need a different set.
• Automatically accept MIRAKL MP orders ingested to Pipe17 (ordersAutoAccept, default: Off) - when enabled, the app auto-accepts Mirakl orders after ingestion. Leave it Off if you want to review orders manually before acceptance.

On the TikTok Shop side, configure location preferences so orders route to the right fulfillment destination. TikTok-fulfilled orders (TTS or FBT) come in as already fulfilled and don't go through the Order Routing Engine.

Best practices

• Decide your catalog source before pushing or pulling product data.
• Audit SKUs for uniqueness across both platforms before going live. Duplicates cause silent mismatches.
• Enable Pull locations from MIRAKL MP before enabling order sync - orders without a valid routing destination will stall.
• Link every Mirakl location to a 3PL or warehouse before going live.
• Confirm the Mirakl order statuses to pull list matches what your operations team expects to see in the app.
• If you want manual control over which Mirakl orders to fulfill, leave Automatically accept MIRAKL MP orders ingested to Pipe17 Off.
• Test with a few products and orders before enabling full sync.
• For non-US/UK TikTok Shops, manage the TikTok catalog directly in TikTok Shop.

Troubleshooting

• Mirakl connection fails after entering credentials
  Re-check MIRAKL MP URL and MIRAKL MP API Key against the values from your Mirakl operator. A single typo blocks authentication. Confirm the URL points to the correct environment.
• Products aren't appearing in Mirakl
  Confirm the Mirakl connector's product push setting is enabled and that a catalog source is feeding the app. If TikTok Shop is the source, verify Pull products from Tiktok to Pipe17 is selected on the TikTok Shop connector.
• Products aren't matching across channels
  Check that SKUs match exactly - including case and any leading or trailing characters. If a Mirakl SKU legitimately differs from the master SKU, map it in the Mirakl row of Channel Options.
• The wrong product is being matched
  Two different products likely share a SKU. Update the SKU on one of them and re-map through Channel Options if needed.
• The Channel SKU column is missing on the TikTok Shop row
  Expected. TikTok Shop doesn't support per-channel SKU mapping. The TikTok SKU must match the master SKU in the app.
• The Channel SKU column is hidden on a parent product
  Open a child or variant product to set channel SKUs.
• Mirakl locations aren't appearing under Inventory → Locations
  Confirm Pull locations from MIRAKL MP is enabled on the Mirakl connector. Locations are not pulled by default.
• Orders aren't ingesting from Mirakl
  Confirm the orders sync setting is enabled and that the connection shows as active. Check that the Mirakl order statuses to pull filter includes the statuses you expect. Verify Mirakl locations exist in the app and are linked to a 3PL or warehouse - orders without a valid routing destination will stall.
• Orders are stuck in WAITING_ACCEPTANCE
  Enable Automatically accept MIRAKL MP orders ingested to Pipe17 if you want the app to accept Mirakl orders after ingestion. Otherwise, accept them manually.
• Mirakl inventory totals look wrong
  Verify the inventory sync setting is enabled and that the relevant locations are mapped correctly. Check whether Report inventory updates only for products with specific SKUs or Do not process inventory information for products with specific SKUs is configured - those settings limit which products receive updates. If totals still look off, enable Force inventory resync on the Mirakl connector to refresh.
• A Mirakl or TikTok Shop order routed to the wrong location
  SKU matching links product records but does not control fulfillment routing. Review the location configuration on the relevant connector and confirm each location is linked to the correct 3PL or warehouse.
• Products aren't pushing to TikTok Shop
  Pushing products to TikTok Shop is available only for US and UK regions. If you sell outside the US or UK, manage the TikTok Shop catalog directly in TikTok Shop.

Need Help?

If you need additional assistance:

• Use Ask Pippen, our AI agent, located at the top of the app page.
• Submit a support request with as much relevant detail as possible. Learn how to submit a request.
• For urgent issues, email us directly at support@pipe17.com.

We're here to help you succeed with your operations.