How to Connect Your 3PL's Warehouse Management System (WMS) in Luminous

Last updated: October 11, 2026




Step 1: Access Settings

  1. Log into Luminous.

  2. In the top-right corner, click your name to open the menu.

  3. Select Settings, then Integrations (under the Integrations section).


Step 2: Add an Integration

  1. Click Add Integration in the top-right corner.

  2. Search the integration catalog for your 3PL's WMS (e.g., ShipHero) and select it.

  3. Under Name this connection, keep the pre-filled name or change it (e.g., Ship Hero - 3PL).


Step 3: Configure Settings

  1. Choose the Inventory Quantity Type:

    • onhand: Recommended as it includes pending numbers.

    • sellable (or another type): Optional, depending on your needs.

  2. Click Show 10 settings you can adjust after connecting and toggle options as needed:

    • Get Fulfilled Orders Only: Leave this unchecked unless specifically required.

    • Enable Get Products and Show Inventory Location to verify inventory synchronization.


Step 4: Authenticate and Connect the WMS

  1. Click Authorize (e.g., Authorize ShipHero). A TrackStar window opens over the page and takes you to your WMS to sign in, then returns you to Luminous.

  2. Authenticate the connection:

    • For Ship Hero: Sign in with the ShipHero login provided by your 3PL in the TrackStar window.

    • For other systems (e.g., AMS): Use the credentials or API details supplied by your 3PL.

  3. Complete the authentication process, then click Save.


Step 5: Verify Inventory Sync

  1. Once connected, ensure inventory is pulling correctly:

    • Go to Manage → Locations in Luminous.

    • Select Warehouse Groups and create a new group for your 3PL.

  2. Configure the warehouse group:

    • Name the group appropriately (e.g., 3PL Warehouse - Ship Hero).

    • Toggle Externally Managed.

    • Assign the connected 3PL account (e.g., Ship Hero).


Step 6: Start Inventory Flow

Once the setup is complete, inventory data from the 3PL will begin flowing into Luminous. Verify by checking:

  • Inventory levels under Products.

  • Locations and stock within the Warehouse Groups section.


By following these steps, your 3PL’s WMS will be seamlessly integrated with Luminous, ensuring efficient inventory and sales order management.