The Linnworks integration enables you to connect your Linnworks account to Mintsoft, allowing automatic order import, purchase order management, and inventory synchronisation. This guide explains how to generate your Linnworks API key and configure the integration within Mintsoft.
Integration capabilities
The Linnworks integration provides the following functionality:
Imports sales orders in paid status from Linnworks.
Option to import purchase orders from Linnworks as ASNs.
Option to automatically create new products when importing orders, purchase orders, or ASNs from Linnworks.
Option to send back returns data processed on Mintsoft.
Option to filter and synchronise data by location (warehouse).
Linnworks fulfilment centre locations
The Linnworks integration with Mintsoft won't work with locations tagged as fulfilment centre on Linnworks. This will prevent the integration from importing orders and marking them as despatched, as it puts the orders in parked status. You need to make sure that the locations are normal locations on Mintsoft (even if used at a fulfilment centre). Linnworks fulfilment centre locations can only be used with FTP export processes.
Note: By default, Mintsoft imports orders set as parked on Linnworks. However, fulfilment centre locations create issues because orders get stuck in parked status on Linnworks' side. If needed, you can enable the IgnoreParkedOrders option (described in step 13) to skip importing parked orders.
Generate Linnworks API key
Before adding the Linnworks integration to Mintsoft, you must generate API keys.
Important: You'll need to complete this prerequisite before you can add the connection to Mintsoft.
To generate your Linnworks API key:
Click here and log in using your Linnworks.net account credentials.
On the Application Installed dialogue, click Copy.
Take note of the API token, as you'll need this later.
Now you can add the connection to Mintsoft.
Add a Linnworks connection
Once you have the Linnworks API keys, the next step is to add the account to Mintsoft.
To add a Linnworks account:
Click Connect then Order Integrations.
Next, click Linnworks.
Click Create New.
(3PL only) Choose the client.
Select the warehouse and channel.
Paste the API token.
Paste 00000000-0000-0000-0000-000000000000 into the Location field. However, if you have multiple locations, please review the multiple locations section below.
Set the frequency to import orders and synchronise dispatch updates back to Linnworks.
(Optional) Enable AutomaticallyImportNewProducts. When enabled, if an order contains a product that doesn't exist in Mintsoft, the system will automatically create it by fetching product details from Linnworks (including SKU, name, dimensions, weight, and image). This applies to both sales orders and purchase orders/ASNs.
(Optional) Enable Import Purchase Order as ASN. This will import purchase orders from Linnworks as ASNs on Mintsoft.
(Optional) Enable Export Returns. This will export returns from Mintsoft to Linnworks. This will follow the frequency set in step 8.
(Recommended for 3PLs) Set an OrderPrefix.
(Optional) Enable IgnoreParkedOrders. By default, Mintsoft will import orders set as parked on Linnworks. Enabling this will stop this import.
(Optional) Enable LogAPIRequests. (3PL only) This will email any client users listed in the Connect Notifications field on the client notifications page with import errors relating to orders coming from Linnworks. This is turned off after 48 hours to prevent overuse.
(Optional) Enable MapSubSourceToChannel. This means Linnworks will automatically map the channel within Mintsoft to the original source field on the Linnworks order, provided both values match exactly (for example, eBay). This feature works with both source and sub-source values.
(Optional) Enable WeightInGrams. If enabled, this will import the product weight as grams from Linnworks.
(Optional) Enable Import Required Despatch Date. If enabled, this will import the required despatch date from Linnworks.
(Optional) Enable SyncStockLevels and set the stock sync frequency. Stock sync sends inventory levels from Mintsoft to Linnworks and is independent from product import and order processing. You can import orders and products without enabling stock sync.
Choose the StockSyncValueType: OnHand (this syncs the OnHand level within Mintsoft) or Stock Level (this sync includes all stock regardless of state).
Make the connection Active when ready.
Finally, click Add.
Note: Stock sync only updates inventory levels from Mintsoft back to Linnworks. It doesn't import or sync product details, images, or other product data. Product data is only imported when AutomaticallyImportNewProducts is enabled during order/ASN processing.
Multiple locations
If you have multiple locations on Linnworks you fulfil from, you can choose which location you want for the Mintsoft connection.
Once you've added the Linnworks account to Mintsoft:
Scroll to the right of the newly added connection and click View Locations. This will show you the full list of locations.
Copy the required location ID.
Click Back then click Edit against the connection.
Paste in the correct location ID.
Click Update.
Additional support
For additional troubleshooting, please review our Linnworks FAQ help guide.