You are currently viewing documentation for Linnworks Desktop, if you are looking for documentation, click here.

ShipStation Integration

ShipStation Integration Setup



This document describes the setup of a ShipStation integration within Linnworks.  You can also find information about what functions Linnworks can perform while working with ShipStation, and how to configure this integration.



  • Active ShipStation account.
  • Access to account.


Quick Guide to Integration Process

  • 1. Login to your account;
  • 2. Create an endpoint for ShipStation in your account > Settings > Shipping Service > ShipStation;
  • 3. Add a Linnworks channel to your ShipStation account.


Detailed Guide to Integration Process

To integrate Linnworks into your ShipStation account, you must add an endpoint for ShipStation and a new user to be used for integration.


1. Login to your account

To login to your Linnworks account go to, and sign in using your account admin credentials.


2. Add ShipStation Integration in Linnworks

To add a new ShipStation Integration:

  • 1. Go to Settings > Shipping Service > ShipStation; ShipStation Navigation
  • 2. Click Add new button to create a new integration;Add New Integration
  • 3. Enter a unique name into the ShipStation Integration, so that the account can be identified at a later date;New Integration
  • 4.In the setting labelled Export orders from a specific folder, select a folder name to act as the source location. If not specified, ShipStation will pick up all orders, except the ones assigned to fulfillment centers;Select Folder
  • 5. In the field Mark exported orders with a tag, select a tag value to be assigned to orders after they are exported to ShipStation. This will show in Open Orders;Tag
  • 6. In the Auto processs orders from location field select the Linnworks location the orders will be processed directly on ShipStation for. Multiple locations require multiple integrations;Tag
  • 7. The Export composite items field determines if child items will be displayed in ShipStation, select 'Yes' or 'No'; Tag
  • 8. In the ShipStation Default Service field, select the shipping service to be used when exporting the order to ShipStation;Tag
  • 9. In the Linnworks Default Service field, select the shipping service to be used when the order is processed by ShipStation with a shipping service unknown to Linnworks. ShipStation enabled
  • 10. Click Create to complete the creation of the ShipStation integration.Tag
  • 11. By Default, the integration will be Disabled.
    • To make the integration active, click the Disabled control to make it show Enabled.
    • At this stage Linnworks is still not actually connected to a ShipStation account.Tag


2.1 Shipping Service Mapping

When processing order information from ShipStation, Linnworks will allocate a shipping service based on the shipping service mapping. The service mapping screen is accessible by clicking the Allocate button next to the integration name.Tag

From this screen you can perform the following actions:

  • Select Default ShipStation Service - a ShipStation service, that will be assigned to the order when submitting it to ShipStation.
  • Select Default Linnworks Service - a Linnworks service, that will be assigned to the order in case ShipStation service used to despatch the order is not mapped with any Linnworks service.
  • Link Linnworks ShipStation Services to Linnworks Shipping Services to define which Linnworks Shipping Services will be assigned to orders when processing shipping information received from ShipStation

To link a ShipStation Service with Linnworks Shipping Service:

  • 1. Select ShipStation service from a drop-down list at the lower section of mapping screen;
  • 2. Select the corresponding Linnworks service from the drop-down list of existing services;
  • 3. Click Add Mapping button;Allocate screen
  • 4. Repeat steps 1-3 for all services that need to be mapped;
  • 5. Click Save.

2.2 Configurations

Clicking the Configure button for a specified integration will bring up the integration settings menu.Configurations

This screen has the following options:

  • Export orders from a specific folder - instruct Linnworks to only submit orders assigned to a specific existing folder. If not specified, Linnworks will export all orders, except the ones assigned to fulfillment centers.Configurations
  • Mark exported orders with a tag - if specified, Linnworks will tag orders that have been passed to ShipStation, for order lifecycle tracking purposes.Configurations
  • Auto process orders from location - Allows for orders from a specific Linnworks location to automatically be processed in Linnworks once they are 'Marked as Shipped' on ShipStation.Configurations
  • Export composite items - if checked, this will include children SKUs that form a composite product to be exported to ShipStation.Configurations


If you would like ShipStation to pull orders from multiple Linnworks folders or auto process orders from multiple locations, a unique endpoint should be created for each folder, meaning that you will need to add multiple integrations both in Linnworks and ShipStation.


3. Integrate Linnworks with ShipStation

To add Linnworks account into your ShipStation, go to:

  • 1. Your ShipStation Account Settings; Account Settings
  • 2. Selling Channels;Selling Channels
  • 3. Click Connect a Store or Marketplace;Connect Selling Channel
  • 4. Select Linnworks;Connect Selling Channel
  • 5. Enter your Linnworks username and password (these are the account main creadentials used to login to;Selling Channel Credentials
  • 6. Paste endpoint link into URL to Custom XML Page field (auto-generated link next to ShipStation integration name in Linnworks);
  • 7. Test Connection, store configuration alert saying ‘Looks good!’ should appear;Test Connection
  • 8. Click Finish to save integration;Save Integration
  • 9. On the next screen, fill in the store information and check the box next to Allow this store to "auto-update" periodically;Auto Update
  • 10. Save Changes.Save Integration


3.1 Additional Settings

In case orders are pulled from multiple Linnworks folders and multiple warehouses are used to process orders in ShipStation, you might want to map your integrated Linnworks channels with specific ShipStation Warehouses, using ShipStation Automation Rules.

To set up a new rule, go to:

  • 1. ShipStation Account Settings > Automation Rules > Create a Rule;Automation Rules
  • 2. Type in a rule name;
  • 3. Select Only apply these actions to orders that match specific criteria option;
  • 4. Click Add Criteria;New Rule
  • 5. Set the criteria, as 'Store’ ‘Equals’ [Relevant Store Name];New Store Rule
  • 6. Click Add an Action;New Store Rule
  • 7. Set the action, as ‘Set Warehouse’ [Relevant Warehouse Name];Set Warehouse
  • 8. Click Save Changes;
  • 9. Repeat steps 1-8 for each warehouse, that needs to be mapped with Linnworks folder.



ShipStation also offers integrations with major selling channels, so marketplaces and web stores, that are integrated in Linnworks, should be disabled in ShipStation, to avoid duplicate shipments.
Since Linnworks is the master record for all your orders and stock levels, it is strongly recommended that all order management processes like canceling orders or making modifications are done in Linnworks directly.