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). For the full MIRAKL MP setup and settings, see Connect MIRAKL MP to Pipe17. The app also offers a MIRAKL connector that uses OAuth and an environment selector (see Connect MIRAKL to Pipe17) and a MIRAKL Connect connector (see Connect Mirakl Connect to Pipe17). If your account uses one of those, contact Pipe17 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.

Step 1: Connect Mirakl

1. Navigate to Integrations, click Add integration, and select MIRAKL MP. The connection pop-up opens.
2. Enter:
   • MIRAKL MP URL - your Mirakl environment URL.
   • MIRAKL MP API Key - from your Mirakl operator.
3. Click Connect. Mirakl authenticates with the credentials you entered - there is no OAuth redirect.
4. On Integrations, confirm the integration shows Connected and its switch is on.

Note: If you don't have your credentials yet, click Add without credentials. The integration is added but doesn't sync until you enter them on its Connection Details tab and click Save.

Step 2: Connect TikTok Shop

1. If TikTok Shop isn't connected yet, connect it as described in Connect TikTok to Pipe17.
2. On the TikTok integration's Settings tab, in 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 ( available only for US and UK regions) - another connected source (including Mirakl) feeds TikTok Shop. See List products to TikTok Shop.
   • Disabled - when TikTok Shop and Mirakl catalogs are maintained independently.
3. Confirm both integrations show Connected on Integrations.

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, and on the Mirakl connector set Process product catalog information to Push product catalog to MIRAKL MP. The app then pushes the catalog out to Mirakl. By default, Product push scope is Sync product offers only; select Sync both product offers and catalog if the app should also send catalog data.
• 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 channel SKU when it differs

If a product uses a different SKU in Mirakl or TikTok Shop 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 or TikTok Shop row, enter that channel's SKU in the Channel SKU column.
4. Save your changes.

Note: 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 - allow list. Inventory updates push to Mirakl only for the SKUs you list.
• Do not process inventory information for products with specific SKUs - 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, turn on Pull locations from MIRAKL MP.
2. Save the settings. Mirakl locations appear under Inventory > Locations.
3. To publish a warehouse's inventory to a Mirakl location, merge the Mirakl location into the warehouse location that your 3PL or warehouse integration fulfills from. See Merging Locations.

If you share fulfillment infrastructure with TikTok Shop, merge the matching Mirakl locations into the same warehouse locations. If Mirakl uses separate fulfillment, merge each Mirakl location into its dedicated warehouse location. Orders route to fulfillment according to your rules in Order Routing > Routing Rules.

See Using Locations for more on locations.

Step 6: Enable sync and configure order behavior

On the Mirakl connector, turn on the sync settings you need: Pull orders from MIRAKL MP, Process product catalog information (see Step 3), Push inventory updates to MIRAKL MP, and Process fulfillments (pull, push, or both). These settings affect how orders flow in:

• Pull only orders with one of following statuses - 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 (default: Off) - when enabled, the app auto-accepts Mirakl orders after ingestion. Leave it Off if you want to review orders manually before acceptance.
• Accept or reject order lines in MIRAKL MP based on order status update (only for regular orders) (default: Off) - when enabled, the app accepts or rejects order lines in Mirakl as the order status changes in the app.

On the TikTok Shop side, set up your routing rules so orders go to the right fulfillment destination. Orders shipped by TikTok (TTS or FBT) are pulled only when Pull shipped by platform orders is on; they 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.
• Turn on Pull locations from MIRAKL MP before enabling order sync - orders without a valid routing destination will stall.
• Set up every Mirakl location (merged into a warehouse location, with routing rules in place) before going live.
• Confirm the Pull only orders with one of following statuses 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 Process product catalog information is set to Push product catalog to MIRAKL MP, check Product push scope, and confirm 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 integration.
• Products aren't matching across channels
  Check that SKUs match exactly - including case and any leading or trailing characters. If a SKU legitimately differs from the master SKU, map it in that channel's 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 hidden on a product
  The column is hidden on parent products with no channel SKUs set. 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 turned on for the Mirakl connector. Locations are not pulled by default.
• Orders aren't ingesting from Mirakl
  Confirm Pull orders from MIRAKL MP is on and that the integration shows Connected. Check that Pull only orders with one of following statuses includes the statuses you expect. Verify Mirakl locations exist in the app and your routing rules give orders a fulfillment destination - 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 Push inventory updates to MIRAKL MP is on and that the relevant locations are set up 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 your rules in Order Routing > Routing Rules and your location setup under Inventory > Locations.
• 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 platform page.
• Submit a support request with as much relevant detail as possible. Learn how to submit a request.

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