Connect TikTok Shop to The Hut Group

Two things to know before you start:

• The Hut Group setup is complex. Contact your Pipe17 onboarding team before you begin.
• No product sync between THG and the app. Create products directly in THG and in TikTok Shop. The app matches them by identifier and keeps the rest in sync.

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 THG setup:

• THG-supplied credentials: THG realm, THG client ID, THG client secret. Request these from THG support.
• Username and password: You create these in the app and share them back with THG support to complete the handshake.
• THG warehouse list: Names and IDs for each warehouse you'll use, if you plan to pull locations into the app.
• Identifier strategy: Decide how to reconcile THG's UPC with the SKU the app uses. See Step 3.

For more background, see Getting Started with The Hut Group.

Step 1: Connect The Hut Group

1. Add the Hut Group connector from the connector catalog if it isn't already under Integrations.
2. On the first setup screen, configure the initial settings. You can change these later.
3. On the second setup screen, enter:
   • THG realm, THG client ID, THG client secret - from THG support.
   • Username and Password - values you create.
4. Save the configuration.
5. Send the username and password to THG support. THG activates the connection on their side once they have them.

The connection isn't fully active until THG completes their step.

Step 2: Connect TikTok Shop

1. Open the TikTok Shop settings. Under Products → Process product catalog updates, pick the option that matches how you want to handle the TikTok catalog:
   • Pull products from Tiktok to Pipe17 - bring the TikTok Shop catalog into the app for matching.
   • Push products from Pipe17 to Tiktok - only relevant if you have another catalog source connected. US and UK only.
   • Disabled - when you maintain TikTok and THG catalogs independently and only need inventory, fulfillment, and returns sync.
2. Open the Connection Details tab and click Connect to complete OAuth.
3. Confirm both integrations show as connected with no errors.

Step 3: Match products by identifier

THG identifies products by UPC. The app identifies products by SKU. You need to align them before anything else will sync correctly.

Pick one of three approaches and apply it across your full catalog:

Option A - Reverse UPC and SKU in THG Use THG's SKU field to hold the same value as your app's master SKU. This is the simplest path and works well for most setups.

Option B - Map per product in Channel Options The Hut Group connector supports per-product SKU mapping. On each product's page in the app, scroll to Channel Options. The Hut Group row has a Channel SKU column - enter the THG UPC value there.

Notes:

• The TikTok Shop row does not have a Channel SKU column. 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.

Option C - Custom mapping For large or complex catalogs, work with Pipe17 support to set up custom identifier mapping.

Don't mix approaches across products - it makes mismatches hard to diagnose later.

Optional: limit inventory sync to specific SKUs

If you're rolling out THG inventory gradually, use Process inventory information only for products with specific SKUs on the Hut Group connector. Inventory updates push to THG only for products in the list.

Step 4: Set up locations

You can either pull THG locations into the app or create them manually.

Pull locations from THG

1. Get the warehouse name and ID pairs from THG support.
2. On the Hut Group connector, enable Pull locations from THG.
3. Enter the name:id pairs in THG locations.
4. Save. The locations appear under Inventory → Locations.

Create locations manually

1. Go to Inventory → Locations and click Create Location.
2. Enter the location details, including the physical address. The Order Routing Engine uses the address during routing.
3. Leave 3PL Integration blank - THG is a marketplace, not a 3PL.
4. Repeat for each THG location.

Either way, link the locations to your 3PL or warehouse integrations afterward. See Using Locations.

Step 5: Enable sync and backfill orders

• On the Hut Group connector, enable the sync settings. Orders and returns start ingesting.
• By default, only recent orders are pulled. To go further back, set a start date in the Orders section of the connector.
• For history older than 6 months, contact support - some APIs limit how far back orders can be pulled.

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

• Get onboarding involved early.
• Pick your identifier strategy before connecting and stick to it.
• Audit identifiers for uniqueness before going live. Duplicates cause silent mismatches.
• Pull THG locations into the app if THG can supply stable name:id pairs.
• Test with a few orders before enabling full historical ingestion.
• For non-US/UK TikTok Shops, manage the TikTok catalog directly in TikTok Shop.

Troubleshooting

• Connection saved but no data flows
  THG hasn't activated their side yet. Confirm you've sent the username and password to THG support.
• Invalid credentials error
  Re-check THG realm, THG client ID, and THG client secret against the values from THG support. A single typo blocks authentication.
• Orders aren't matching products
  Almost always the UPC-vs-SKU mismatch. Pick one of the three approaches in Step 3 and apply it consistently.
• 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.
• Inventory totals on THG look wrong
  Check that the right locations are aggregated. If totals still look off, enable Force inventory resync on the Hut Group connector to refresh.
• Inventory is updating for the wrong products
  Check whether Process inventory information only for products with specific SKUs is set. If the list is populated, only those products receive updates.
• Orders are missing from a date range
  Set the start date in the Orders section of the Hut Group connector. For ranges over 6 months, contact support.
• A THG order routed to the wrong location
  If you pulled locations from THG, double-check the name:id pairs. If you created them manually, verify each address.
• A TikTok Shop order routed to the wrong location
  Review the location configuration on the TikTok Shop connector. SKU matching does not control routing.
• Returns aren't flowing
  Confirm returns sync is enabled on the Hut Group connector for the direction you need - inbound (THG → App), outbound (App → THG), or both.

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.