--- title: "Integrating with ShipHero" description: "How to connect Order Editing with ShipHero so the warehouse fulfils the final, edited order." url: https://docs.orderediting.com/en/articles/14166037-integrating-with-shiphero collection: "3PL & Fulfilment" updated: 2026-10-27 language: en --- # Integrating with ShipHero How to connect Order Editing with ShipHero so the warehouse fulfils the final, edited order. # Overview ShipHero is a cloud warehouse management and fulfilment platform for ecommerce brands and 3PLs. Order Editing has a direct integration with ShipHero that holds an order in the warehouse while your customer edits it, then releases it so ShipHero picks, packs, and ships the final order. Edits are supported live, right up until picking starts. - The warehouse only ever picks the final, edited order. - Edits are supported live, up until picking begins. - Works for single warehouses, multi-location setups, and 3PLs. # How it works While an order can be edited, Order Editing holds it in ShipHero so the warehouse doesn't start picking it. When the editing deadline passes, or the order is fully paid, Order Editing releases the hold and ShipHero fulfils the final order. ShipHero also tells Order Editing when picking begins. If the warehouse starts work early, the editing window closes automatically so the picked order and the customer's order always match. # Step 1: Add Order Editing as a developer in ShipHero 1. In ShipHero, open your Users page at **app.shiphero.com/dashboard/users** and add a developer user for Order Editing. 2. Generate an **Access Token** and a **Refresh Token**, and copy both. > **Success:** On the Shiphero page in Order Editing, **Get your access tokens** opens the ShipHero Users page, and **View tutorial** shows a short video of this step. # Step 2: Connect ShipHero in Order Editing 1. In Order Editing, go to **Integrations** and open **Shiphero**. 2. In **Authentication Keys**, paste your **Shiphero Access Token** and **Shiphero Refresh Token**. 3. Select **Save Shiphero tokens**. Order Editing checks the tokens and registers the webhooks it needs automatically. 4. Turn on **Use Shiphero integration**. This switch is available once your tokens are saved. 5. To confirm the connection at any time, select **Check status** at the top of the page. # Step 3: Choose your hold behaviour The two hold settings sit on the Shiphero integration page, under **Use Shiphero integration**:

Setting

What it does

When it's available

Disable editing when Shiphero starts picking

Customers can edit until ShipHero assigns the order to a tote. The editing window then closes, so the picked order always matches.

After your tokens are saved.

Hold orders until the editing deadline

Pauses orders in ShipHero until the editing deadline passes, then releases them.

Needs a time-based editing deadline. It can't be turned on when your deadline is custom or set by Shopify Flow.

If **Hold orders while they can be edited** is turned on in your [order hold](/docs/en/articles/14153293-order-holds) settings, **Hold orders until the editing deadline** is switched on automatically and can't be turned off here. The page shows an **Automatically enabled** banner when this happens. # Step 4 (3PL): Warehouse operator settings 1. Select **Advanced** in the page navigation. It's available once ShipHero is connected. 2. Turn on **Enable settings for warehouse operators (3PL)**. 3. Enter your **3PL Name** and **Customer ID**. **Advanced** also shows whether the **Tote Cleared** and **Tote Complete** webhooks were found, and lists any orders Order Editing is currently holding in ShipHero. # Step 5 (multi-location): Location-specific accounts Your Shopify locations are listed under **Locations** in the page navigation. 1. Select a location. 2. Turn on **Enable Shiphero for this location**. 3. If that location uses a different ShipHero account, select **Override tokens** and enter its tokens. Select **Use default tokens** to go back to your default tokens. # Troubleshooting ## Orders are being picked before editing finishes Turn on **Hold orders until the editing deadline** so the hold is placed as soon as the order arrives. If the setting is greyed out, check that your editing deadline is time-based rather than custom or Flow-based. Order Editing only releases holds it placed itself, so it won't interfere with holds your team adds manually. ## Edits made after picking started aren't applied With **Disable editing when Shiphero starts picking** turned on, the editing window closes the moment ShipHero assigns the order to a tote. Edits need to be made before then. ## Multi-location orders aren't holding correctly Check that each location is enabled and that its tokens are set correctly under **Locations**. # Common questions ## Does this support live edits? Yes. Because the integration connects directly to ShipHero, customers can edit right up until the warehouse starts picking. Once picking begins, the window closes automatically. ## Will it interfere with holds my team places in ShipHero? No. Order Editing tracks the holds it places and only releases those. Any holds your team adds in ShipHero are left untouched. ## Related - [Integrating with ShipBob](https://docs.orderediting.com/en/articles/14155896-integrating-with-shipbob.md) - [Integrating with Mintsoft](https://docs.orderediting.com/en/articles/14155893-integrating-with-mintsoft.md) - [Integrating with ShipStation](https://docs.orderediting.com/en/articles/14155873-integrating-with-shipstation.md) - [Order Editing and 3PLs](https://docs.orderediting.com/en/articles/15237738-order-editing-and-3pls.md) - [Order Editing and Fulfilment & Shipping Platforms](https://docs.orderediting.com/en/articles/15316144-order-editing-and-fulfilment-and-shipping-platforms.md)