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 Developer account and access permissions to create applications. |
Log in to the Linnworks developer portal at
https://developer.linnworks.com/#/secure/applicationsClick New App on the Applications page.
In the New Application dialog box, type a Name and select an 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 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.
Linnworks displays a message box with the Installation token.
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 set to any relevant and 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 to create default mappings and want to create all mappings from scratch by yourself, then uncheck this box.
Enter the Poll Orders by Location value. This preset controls which locations' sales orders are polled. When specified, only orders from the listed locations are fetched. When empty or null, orders from all locations are fetched.
Enter the Token generated in Linnworks.
Enter the Application Secret you generated in Linnworks.
Enter the Application ID you generated in Linnworks.
Provide the API URL of the endpoint for your Linnworks instance.
Environment URLs:
Test/Sandbox:
https://eu-ext.linnworks.net/apiProduction: Provided by the client.
Enter the API Throttle Limit. This setting prevents any single integration or user from overwhelming the system with too many requests. It protects system performance by controlling the number of API requests that can run simultaneously, ensuring fair usage.
Recommended Values
Initial Setup: 5
Ongoing Operations: 500
High Volume: 500
Enter the API Throttle Seconds. This defines the time window during which the API Throttle Limit is measured. If an integration makes too many requests within this time window, additional requests are rejected until the window resets.
Default Value: 60 seconds
Range: 60 seconds
Enter the number of Concurrent Connections. This specifies the maximum number of simultaneous API connections that the subscription can process for a user or integration. If this limit is exceeded, new requests are queued or rejected until a currently active connection finishes.
Default Value: 5
Range: 10
Enter the number of Concurrent Batch Executions. This specifies the maximum number of simultaneous batch executions that can process for an integration at one time. If this limit is exceeded, new requests are queued or rejected until a currently active connection finishes.
Default Value: 5
Range: 10
Click Apply to save the settings.
Post-Installation Verification
After completing the installation, perform these tests to verify the installation.
Data Sync Test
Initiate a sample data pull. (To iPaaS.com).
Initiate a sample data push. (From iPaaS.com).
Functionality Test
Run an end-to-end business process.
Validate key features like field mappings, workflow triggers, and logging.
Review integration logs in iPaaS.com.
Support and Troubleshooting
Click the Help button on any iPaaS.com page to contact Support or to search our documentation.
Documentation: Search our documentation at the top of this article
Support Portal: Click the Help and Support button at the lower-right of this window.
Contact Information: Contact iPaaS.com.