Before you begin installing the Linnworks subscription, you need to obtain an Application Id, an Application Secret, and a Token from Linnworks.
NOTE: You must have a registered Linnworks Developer account with permission to create applications.
Log in to the Linnworks developer portal at https://developer.linnworks.com/#/secure/applications
Click New App on the Applications page.
In the New Application dialog box, type a Name and select the Application Type System Integration, the only type that works with iPaaS.com.
Click Create, and Linnworks creates the new application.
Find your app in the list and click Edit.
On the General page, copy the Application Id and the Application Secret.
Click the Installation URL.
On the next screen, agree to the terms, and enter your Linnworks email and password.
Log in to your Linnworks account and click Create Token. Linnworks displays the My API Key dialog box.
On the next screen, select the application version to install and then click Install.
Copy the token and store it in a safe place. If you lose it, you must recreate a new token.
With the Linnworks credentials created and saved, you can begin installing the integration.
Installation Instructions for Integration Setup
Go to Subscriptions Management > Subscriptions and click Search Certified Integration Marketplace and Subscribe.
Click the Linnworks integration title.
On the Subscription Detail page, click the Subscribe button.
Enter the Name of the subscription and select a Version. It can be any relevant, unique subscription name within the company where this subscription is created.
Format: [Product Name] - [Environment/Purpose]
Example: Linnworks - Release
Select Create Default Mappings (recommended). If you don't want the default mappings and prefer to create all mappings yourself, uncheck this box.
Provide the API Url of the endpoint for your Linnworks instance. This is region-specific.
Example (EU): https://eu-ext.linnworks.net/api
Enter the Token generated in Linnworks.
Enter the Application Id and Application Secret you generated in Linnworks, if you are using your own Linnworks application. If these are left blank, the integration uses its built-in application registration.
Enter the Poll Orders By Locations value (optional). This preset controls which locations' sales orders are polled: when set, only orders from the listed locations are fetched; when blank, orders from all locations are fetched.
Enter the API Throttle Limit. This controls how many API requests can run within the throttle window, protecting system performance.
Recommended Values: Initial Setup 5, Ongoing Operations 500, High Volume 500
Enter the API Throttle Seconds — the time window over which the API Throttle Limit is measured.
Default Value: 60 seconds
Enter the number of Concurrent Connections — the maximum number of simultaneous API connections the subscription processes.
Default Value: 10
Enter the number of Concurrent Batch Executions — the maximum number of simultaneous batch executions the integration processes at one time.
Default Value: 10
Click Apply to save the settings.
For an ongoing reference to each of these fields and how authentication works, see the Linnworks Connections and Settings article.
Post-Installation Verification
After completing the installation, perform these tests to verify it.
Data Sync Test
Manually sync a Linnworks order to iPaaS.com and confirm the Transaction is created.
Manually sync a product or stock level from iPaaS.com to Linnworks and confirm the change appears in Linnworks.
Functionality Test
Run an end-to-end business process.
Validate key features such as field mappings and logging.
Review the integration logs in Dashboard / Integration Monitoring / Error Logs.
Support and Troubleshooting
Click the Help button on any iPaaS.com page to contact Support or search the documentation.
Documentation: Search the documentation from the Help menu.
Support Portal: Click the Help and Support button at the lower-right of the window.
Contact Information: Contact iPaaS.com Support.