Linnworks
Use this page to set up the Linnworks source connector and find reference information.
Prerequisites
- A Linnworks account
Setup guide
Generate credentials in Linnworks
- Linnworks has two portals: Seller and Developer. Log in to the developer portal and select + New App to generate your credentials.
- Enter a name for your application and set the Application Type to
System Integration. - Select Edit for your new application. Open the General tab, then find and copy your Application ID and Application Secret. Select Installation URL to complete the app installation and get your API Token.
:::tip You can view your API Token at any time from your account’s main dashboard. It’s listed in your app’s Installs table. :::
Set up the connector in Airbyte
- Log in to your Airbyte Cloud or Airbyte Open Source account.
- In the Airbyte UI, select Sources > + New Source.
- Select Linnworks from the available sources.
- Enter a Name you choose.
- Enter your Application ID, Application Secret and API Token.
- Enter a Start date using the provided datepicker. Incremental sync mode only fetches data generated after this date.
- Select Set up source and wait for the connection test to finish.
Supported streams and sync modes
The Linnworks source connector supports these streams and sync modes:
| Stream Name | Full Refresh | Incremental |
|---|---|---|
| ProcessedOrders | ✓ | ✓ |
| ProcessedOrderDetails | ✓ | ✓ |
| StockItems | ✓ | X |
| StockLocations | ✓ | X |
| StockLocationDetails | ✓ | X |
Data type mapping
| Integration Type | Airbyte Type | Example |
|---|---|---|
number | number | 50.23 |
integer | integer | 50 |
date | string | 2020-12-31 |
datetime | string | 2020-12-31T07:30:00 |
array | array | [“Item 1”, “Item 2”] |
boolean | boolean | True/False |
string | string | Item 3 |
Limitations and troubleshooting
Expand for details about Linnworks connector limitations and troubleshooting
Rate limits
Linnworks API rate limits vary by endpoint. Use the links in the Supported Streams table to check each endpoint’s limits. Rate-limited requests receive a 429 response. However, the Linnworks connector shouldn’t reach Linnworks API limits during normal use.
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.1.66 | 2025-10-14 | 68061 | Update dependencies |
| 0.1.65 | 2025-10-07 | 67530 | Update dependencies |
| 0.1.64 | 2025-09-30 | 66816 | Update dependencies |
| 0.1.63 | 2025-09-24 | 66657 | Update dependencies |
| 0.1.62 | 2025-09-09 | 66059 | Update dependencies |
| 0.1.61 | 2025-08-23 | 65379 | Update dependencies |
| 0.1.60 | 2025-08-16 | 64985 | Update dependencies |
| 0.1.59 | 2025-08-09 | 64611 | Update dependencies |
| 0.1.58 | 2025-07-19 | 63494 | Update dependencies |
| 0.1.57 | 2025-07-12 | 63107 | Update dependencies |
| 0.1.56 | 2025-07-05 | 62568 | Update dependencies |
| 0.1.55 | 2025-06-28 | 62153 | Update dependencies |
| 0.1.54 | 2025-06-21 | 61854 | Update dependencies |
| 0.1.53 | 2025-06-14 | 61076 | Update dependencies |
| 0.1.52 | 2025-05-24 | 59903 | Update dependencies |
| 0.1.51 | 2025-05-03 | 59265 | Update dependencies |
| 0.1.50 | 2025-04-26 | 58771 | Update dependencies |
| 0.1.49 | 2025-04-19 | 58202 | Update dependencies |
| 0.1.48 | 2025-04-12 | 57753 | Update dependencies |
| 0.1.47 | 2025-04-05 | 57089 | Update dependencies |
| 0.1.46 | 2025-03-29 | 56649 | Update dependencies |
| 0.1.45 | 2025-03-22 | 56053 | Update dependencies |
| 0.1.44 | 2025-03-08 | 55464 | Update dependencies |
| 0.1.43 | 2025-03-01 | 54760 | Update dependencies |
| 0.1.42 | 2025-02-22 | 54365 | Update dependencies |
| 0.1.41 | 2025-02-15 | 53815 | Update dependencies |
| 0.1.40 | 2025-02-01 | 52725 | Update dependencies |
| 0.1.39 | 2025-01-25 | 51807 | Update dependencies |
| 0.1.38 | 2025-01-11 | 51157 | Update dependencies |
| 0.1.37 | 2024-12-28 | 50634 | Update dependencies |
| 0.1.36 | 2024-12-21 | 50148 | Update dependencies |
| 0.1.35 | 2024-12-14 | 48880 | Update dependencies |
| 0.1.34 | 2024-11-25 | 48665 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 0.1.33 | 2024-11-04 | 48271 | Update dependencies |
| 0.1.32 | 2024-10-29 | 47877 | Update dependencies |
| 0.1.31 | 2024-10-28 | 47116 | Update dependencies |
| 0.1.30 | 2024-10-12 | 46798 | Update dependencies |
| 0.1.29 | 2024-10-05 | 46406 | Update dependencies |
| 0.1.28 | 2024-09-28 | 46124 | Update dependencies |
| 0.1.27 | 2024-09-21 | 45730 | Update dependencies |
| 0.1.26 | 2024-09-14 | 45571 | Update dependencies |
| 0.1.25 | 2024-09-07 | 45262 | Update dependencies |
| 0.1.24 | 2024-08-31 | 44968 | Update dependencies |
| 0.1.23 | 2024-08-24 | 44740 | Update dependencies |
| 0.1.22 | 2024-08-17 | 44304 | Update dependencies |
| 0.1.21 | 2024-08-10 | 43604 | Update dependencies |
| 0.1.20 | 2024-08-03 | 43183 | Update dependencies |
| 0.1.19 | 2024-07-27 | 42608 | Update dependencies |
| 0.1.18 | 2024-07-20 | 42235 | Update dependencies |
| 0.1.17 | 2024-07-13 | 41778 | Update dependencies |
| 0.1.16 | 2024-07-10 | 41432 | Update dependencies |
| 0.1.15 | 2024-07-09 | 41219 | Update dependencies |
| 0.1.14 | 2024-07-06 | 40870 | Update dependencies |
| 0.1.13 | 2024-06-26 | 40549 | Migrate off deprecated auth package |
| 0.1.12 | 2024-06-25 | 40275 | Update dependencies |
| 0.1.11 | 2024-06-22 | 40146 | Update dependencies |
| 0.1.10 | 2024-06-06 | 39196 | [autopull] Upgrade base image to v1.2.2 |
| 0.1.9 | 2024-04-19 | 37188 | Updating to 0.80.0 CDK |
| 0.1.8 | 2024-04-12 | 37188 | schema descriptions |
| 0.1.7 | 2024-02-22 | 35557 | Manage dependencies with Poetry |
| 0.1.6 | 2024-01-31 | 34717 | Update CDK and migrate to base image |
| 0.1.5 | 2022-11-20 | 19865 | Bump Version |
| 0.1.4 | 2021-11-24 | 8226 | Source Linnworks: improve streams ProcessedOrders and ProcessedOrderDetails |
| 0.1.3 | 2021-11-24 | 8169 | Source Linnworks: refactor stream StockLocations |
| 0.1.2 | 2021-11-23 | 8177 | Source Linnworks: add stream ProcessedOrderDetails |
| 0.1.0 | 2021-11-09 | 7588 | New Source: Linnworks |