Linnworks Integration

The Linnworks integration connects EventWorks to your Linnworks account, letting you sync your stock items and variation groups into your resource library, create orders from event costs, and import orders from Linnworks as new events.

Getting There

Go to Settings > Integrations and find the Linnworks card. Click Connect to enter your credentials and configure the integration.

Overview

Once connected, Linnworks provides three main capabilities:

Sync products — Import stock items and variation groups from Linnworks as resources and variants in EventWorks
Create orders — Push orders to Linnworks from your event cost sheets, matched by SKU
Import orders — Pull open Linnworks orders into EventWorks as new events with accounts, contacts, and costs

Key Concepts

Token-Based Authentication

Linnworks connects using an App ID, App Secret, and authentication token from your Linnworks account.

SKU Matching

When creating orders, EventWorks matches cost line items to Linnworks products using SKU codes. Resources and variants need matching SKUs from the product sync.

Variation Groups

Linnworks supports variation groups (e.g. a product in multiple sizes or colours). During product sync, variation groups are imported as resources with each variation as a variant.

Attribute Mapping

Delivery address fields, contact details, and other order data are mapped to EventWorks custom attributes, just like with Veeqo.

How To...

Connect to Linnworks

Go to Settings > Integrations.
Click the Linnworks card.
Fill in the connection details:

- App ID — Your Linnworks application ID - App Secret — Your Linnworks application secret - Token — Your Linnworks authentication token - Location — The Linnworks location identifier for order creation - Import View ID — (Optional) A view ID for filtering during import - Import Location ID — The stock location/fulfilment centre ID

Configure attribute mappings for imported order data (contact name, phone, address fields, delivery method, gift message).
Set the Import status and Import type for events created from imported orders.
Click Save.

Sync Products from Linnworks

To import your Linnworks product catalogue into EventWorks:

On the Linnworks integration card, click Sync products.
EventWorks syncs both variation groups and individual stock items:

- Variation groups become resources, with each variant as a variant record - Stock items become resources with a default variant - Images are fetched for each resource and variant

Products are matched by SKU — existing resources are updated, not duplicated.

Create Orders in Linnworks

To push event costs as orders to Linnworks:

Navigate to the event's Costs or Resources page.
Use the Send to Linnworks action.
EventWorks creates orders in Linnworks with:

- Customer billing details from the event's account and contact - Delivery address from the event's venue or custom attributes - Line items matched by SKU to Linnworks products - Event code as the order reference number - Extended properties including due date, description, and gift message

Order creation runs in the background and tracks progress. You can check the status of order creation from the event page.

Note: Only costs with resources that have matching Linnworks SKUs will be included in orders.

Import Orders from Linnworks

To pull Linnworks orders into EventWorks as events:

On the Linnworks integration card, click Import orders.
EventWorks fetches recent open orders from Linnworks.
Each order becomes a new event with:

- An account created from the billing company or customer name - A contact created from the billing email and name - Costs created from each order line item, linked to the matching resource variant - Delivery details mapped to your configured custom attributes - A date record created from the order's dispatch-by date

Disconnect Linnworks

On the Linnworks integration card, click Disconnect.

Settings & Configuration

All Linnworks settings are configured in the connection modal at Settings > Integrations. You need the edit settings permission.

Connection Settings

Setting	Description
App ID	Linnworks application ID
App Secret	Linnworks application secret
Token	Linnworks authentication token
Location	Location identifier for order creation
Import View ID	View ID for filtering during import
Import Location ID	Stock location / fulfilment centre ID

Import Settings

Setting	Description
Import status	Event status assigned to imported orders
Import type	Event type assigned to imported orders

Attribute Mappings

Map Linnworks order data to EventWorks custom attributes:

Field	Description
Contact name	Custom attribute for the customer's name
Contact phone	Custom attribute for the customer's phone
Address 1	Custom attribute for delivery address line 1
Address 2	Custom attribute for delivery address line 2
City	Custom attribute for the delivery city
County	Custom attribute for the delivery county/state
Postcode	Custom attribute for the delivery postcode
Country	Custom attribute for the delivery country
Delivery method	Custom attribute for the delivery method
Delivery/set up field	Custom attribute for delivery/set-up type
Gift message	Custom attribute for gift messages

Frequently Asked Questions

Q: How are variation groups handled?

Linnworks variation groups are imported as a single resource in EventWorks, with each variation item becoming a separate variant. This preserves the group structure and lets you allocate specific variants to event costs.

Q: Are product images imported?

Yes. During product sync, images are fetched from Linnworks for both resources and variants. The main image for each item is used.

Q: Can I track order creation progress?

Yes. When creating orders, the progress is tracked in the background. You can check the status from the event page.

Q: What happens to already-imported orders?

Imported line items are tracked by their Linnworks ID. If an order has already been imported, its existing items are skipped to prevent duplicates.