---
title: Linnworks API Integration on Truto
slug: linnworks
category: E-Commerce
canonical: "https://truto.one/integrations/detail/linnworks/"
---

# Linnworks API Integration on Truto



**Category:** E-Commerce  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 743 tools for Linnworks that AI agents can call directly.

- **get_auth_get_application_profile_by_secret_key_by_id** — Get the current linnworks application subscription profile for a specific user, typically after AuthorizeByApplication returned a session. Returns: PlanTag, PlanName, ActivationDate, LastPaymentDate, NextPaymentDate, ProfileExpires, IsProfileActive. Requires applicationId, applicationSecret, and userId (the session's Id). Returns null when the user has no current subscription.
- **create_a_linnworks_auth_authorize_by_application** — Create a Linnworks session for an installed application, exchanging the developer-portal credentials for an authorization token and server. Returns: Id, EntityId, DatabaseName, DatabaseServer, PrivateDatabaseServer, DatabaseUser, DatabasePassword, AppName, sid_registration, UserName, Md5Hash, Locality, SuperAdmin, TTL, Token, AccessToken, GroupName, Device, DeviceType, UserType, Status, UserId,…
- **list_all_linnworks_dashboards_get_low_stock_levels** — Get the "Low stock in location" report from Linnworks dashboards. Returns low stock rows including ItemTitle, ItemNumber, Quantity, MinimumLevel, InBooks, and Location.
- **list_all_linnworks_dashboards_get_performance_table_datas** — Get the linnworks Performance table report data. Returns an array of report entries with Name, Price, and Currency.
- **list_all_linnworks_dashboards_get_performance_details** — Get the linnworks "Performance through time chart" report: a dictionary of time-scale keys, each mapping to an array of performance detail points. Returns: Date, Value.
- **list_all_linnworks_dashboards_get_top_products** — Get a report of the top ordered products in linnworks, grouped by quantity or turnover. Returns an array of product rows including RowNum, Quantity, Cost, Title, SKU, and Currency.
- **list_all_linnworks_dashboards_get_inventory_location_datas** — Get the 'Stock info for locations' dashboard report from linnworks. Returns: StockLocationId, Location, StockLevel, StockValue. Pass date for a specific report date or omit it for the current period.
- **list_all_dashboards_get_inventory_location_categories_datas** — Get the Linnworks "Stock info for categories in a specific location" report for a date and location. Returns an array of per-category records with StockLocationId, CategoryName, CategoryId, StockLevel, and StockValue. Pass date to target a report date (omit for the current period) and locationId to select the stock location.
- **list_all_dashboards_get_inventory_location_products_datas** — Get a paged report of stock info for products in a specific category and location in linnworks. Returns: TotalResults and Results (per product: ItemNumber, ItemTitle, StockLevel, StockValue). Omit date to report on the current period.
- **list_all_linnworks_email_get_email_templates** — List all email header templates in linnworks. Returns each template header with pkEmailTemplateRowId, Name, TemplateType, Condition, Enabled, AccountName, and HTML/attachment flags. Takes no parameters.
- **get_single_linnworks_email_get_email_template_by_id** — Get the full data of a specific linnworks email template. Returns the template's pkEmailTemplateRowId, Name, Subject, Body, TemplateTypeDefinition, Condition, Enabled, and HTML/attachment flags. Required: pkEmailTemplateRowId.
- **create_a_linnworks_email_generate_adhoc_email** — Generate and send a custom adhoc email in linnworks. Returns: isComplete (whether the send completed) and FailedRecipients (recipient addresses that failed). Requires a JSON request body (the adhoc email request object).
- **create_a_linnworks_email_generate_free_text_email** — Generate and send a custom free-text email in Linnworks. Returns: isComplete (whether the send completed) and FailedRecipients (list of failed recipients). Required: a request body matching the upstream Email_GenerateFreeTextEmailRequest schema.
- **create_a_linnworks_generic_listings_save_template_field** — Update the fields on a generic listing template in linnworks, such as one created with the CreateTemplates endpoint. Sends the template field data as a JSON request object and returns the template field save result object. Required: request.
- **create_a_linnworks_generic_listings_process_template** — Process generic listing templates in linnworks: push templates created via the CreateTemplates endpoint to the channel, or use it to update, relist, or delete an existing template from the channel. Returns a 200 OK response object whose fields are not enumerated in the upstream reference. Required: request.
- **create_a_linnworks_generic_listings_create_template** — Create generic listing templates in Linnworks based on inventory item details and configurator details; each template contains the full details of the item that will be listed on the channel. Returns: TemplatesInfo (created template objects) and AllCreatedIds (ids of the created templates). Required: request.
- **create_a_linnworks_generic_listings_open_templates_by_inventory** — Open Generic Listing Tool templates for linnworks stock items by supplying the stock item identifiers in the request body. Returns: TotalEntries and TemplatesInfo (template details; fields vary by channel template). Requires a JSON request body identifying the inventory items.
- **get_generic_listings_get_configurators_info_paged_by_id** — Get the existing Generic Listing Tool (GLT) configurators from linnworks, one page at a time. Returns a ConfiguratorsInfo array of configurator info objects whose fields are channel-specific. Requires a request body (paged configurator info request object).
- **create_a_linnworks_generic_listings_save_configurator_field** — Update the fields of a Generic Listing Tool (GLT) configurator in linnworks. Returns the save response object. Requires a JSON request body.
- **get_generic_listings_get_configurator_description_by_id** — Get the existing Generic Listing Tool configurator description from linnworks. Returns the Data field holding the configurator's description payload as a string. Requires a request body object.
- **create_generic_listings_save_configurator_description** — Update the description of a Generic Listing Tool (GLT) configurator in linnworks. Returns: IsSaved, ErrorMessage. Requires a JSON request body identifying the configurator and its new description.
- **get_generic_listings_get_configurator_data_by_id** — Get the existing Generic Listing Tool (GLT) configurator data in linnworks. Returns: Data. Requires a request body (the request object is mandatory); the method takes no query parameters.
- **create_a_linnworks_generic_listings_save_configurator_data** — Update a Generic Listing Tool configurator's data (its attributes) in Linnworks. Returns: IsSaved, ValidationResults. Requires a JSON request body with the configurator's data; the body is required.
- **create_a_linnworks_generic_listings_create_configurator** — Create a Generic Listing Tool configurator in linnworks. The configurator setup depends on the channel it is being created for, so the required request body is channel-specific. Returns: CreatedConfiguratorInfo, CreatedConfiguratorId.
- **delete_a_linnworks_generic_listings_delete_configurator_by_id** — Delete a Generic Listing Tool configurator in Linnworks. Returns a 200 OK response body (DeleteConfiguratorsResponse); the discovered Linnworks docs do not enumerate its fields. Requires a JSON request body.
- **create_a_linnworks_import_export_enable_import** — Enable or disable a specific import in linnworks. Returns the import register for the affected import, including its id and the upstream register fields (attributes). Requires a JSON request body.
- **create_a_linnworks_import_export_run_now_import** — Queue a specific Linnworks import to run immediately by putting it in the processing queue. Returns an empty 204 response on success. Requires a JSON request body identifying the import to run.
- **list_all_linnworks_import_export_get_imports** — Get a single import configuration in linnworks by its id. Returns the Import configuration object including its id. Required: id.
- **delete_a_linnworks_import_export_delete_import_by_id** — Delete an import configuration in Linnworks. Returns an empty 204 response on success. Required: id (the import configuration to delete).
- **list_all_linnworks_import_export_get_fullfilment_center_settings** — Get the fulfillment center import/export settings in Linnworks. Returns the settings record including its id and attributes; the attribute fields follow the upstream FulfilmentCenterImportExportSettings schema.
- **create_a_linnworks_import_export_enable_export** — Enable or disable a specific export in Linnworks. Returns the export's register record including its id.
- **create_a_linnworks_import_export_run_now_export** — Run a specific Linnworks export immediately by putting it in the processing queue. Returns an empty 204 response on success. Required: a JSON request body identifying the export to run.
- **list_all_linnworks_import_export_get_exports** — Get an export configuration from Linnworks by its id. Returns the export configuration record identified by id. Required: id.
- **delete_a_linnworks_import_export_delete_export_by_id** — Delete an export configuration in linnworks. Returns an empty 204 response on success. Requires a JSON body identifying the export to delete.
- **list_all_linnworks_import_export_get_import_lists** — List all existing import configurations in Linnworks. Returns the collection of existing imports as a single GetImportListResponse payload; the upstream schema is not expanded, so individual import fields are not documented. Takes no parameters.
- **list_all_linnworks_import_export_get_export_lists** — List all existing export configurations in Linnworks. Returns the export list payload (GetExportListResponse); the upstream API reference does not document its field-level structure. Takes no parameters.
- **create_a_linnworks_inventory_create_stock_supplier_stat** — Create a supplier stat for a stock item in linnworks via CreateStockSupplierStat. The request must include a JSON body following the Inventory_CreateStockSupplierStatRequest schema. Returns an empty 204 response on success.
- **update_a_linnworks_inventory_update_stock_supplier_stat_by_id** — Update an item supplier stat in linnworks. Requires a JSON request body matching the upstream Inventory_UpdateStockSupplierStatRequest schema (field-level breakdown not enumerated in the Linnworks docs). Returns an empty 204 response on success.
- **delete_a_linnworks_inventory_delete_stock_supplier_stat_by_id** — Delete an item supplier stat in linnworks. Returns an empty 204 response on success. Requires a JSON request body identifying the supplier stat to remove, per the upstream Inventory_DeleteStockSupplierStatRequest schema.
- **list_all_linnworks_inventory_get_inventory_item_prices** — Get a Linnworks stock item's prices by channel. Returns an array of price records with: id, attributes — the channel-specific price fields are defined in the upstream StockItemPrice schema but not enumerated in the docs. Takes inventoryItemId (stock item id, UUID).
- **create_a_linnworks_inventory_create_inventory_item_price** — Create stock item prices for a specific channel in Linnworks. Requires a JSON request body (upstream schema: Inventory_CreateInventoryItemPricesRequest). Returns an empty 204 response on success.
- **update_a_linnworks_inventory_update_inventory_item_price_by_id** — Update stock item prices in Linnworks. Returns an empty 204 response on success. Requires a JSON request body conforming to Linnworks' UpdateInventoryItemPrices request schema; the upstream docs do not enumerate its fields, so consult the Linnworks API reference for the exact payload shape.
- **delete_a_linnworks_inventory_delete_inventory_item_price_by_id** — Delete stock item prices in linnworks. Returns an empty 204 response on success. Requires a JSON request body identifying the stock item prices to delete.
- **list_all_inventory_get_inventory_item_price_channel_suffixes** — List all possible price change subsource suffixes across every channel in Linnworks. Returns a channel-keyed map where each channel name maps to an array of suffix strings.
- **list_all_linnworks_inventory_get_inventory_item_price_tags** — Get all possible price change tags for all channels in Linnworks. Returns a map of channel name to the array of price change tag strings available for that channel. No required parameters.
- **list_all_inventory_get_inventory_item_price_rules_by_ids** — Get the stock item price rules for a specific item price in Linnworks. Returns an array of stock item pricing rule objects matching the supplied price ID. Required: stockItemPriceId (UUID of an item price).
- **list_all_inventory_get_inventory_item_price_rules_by_sources** — Get Linnworks stock item price rules for a stock item on a specific channel source and subsource. Returns an array of pricing-rule records, each with an id and the rule fields defined by Linnworks' StockItemPricingRule schema. Required: stockItemId, source, subSource.
- **create_a_linnworks_inventory_create_inventory_item_pricing_rule** — Create stock item price rules in Linnworks by posting the rule definitions as a JSON request body. Returns an empty 204 response on success. Requires the pricing rule request body.
- **delete_inventory_delete_inventory_item_pricing_rule_by_id** — Delete stock item pricing rules in linnworks by submitting the rules to remove. Requires a JSON request body per the upstream delete-pricing-rules request schema (its fields are not enumerated in the discovered documentation). Returns an empty 204 response on success.
- **update_inventory_update_inventory_item_pricing_rule_by_id** — Update stock item pricing rules in linnworks. Returns an empty 204 response on success. Required: a JSON request body describing the pricing rules to apply.
- **list_all_linnworks_inventory_get_inventory_item_descriptions** — Get stock item descriptions from Linnworks. Returns an array of StockItemDescription records for the stock item matching inventory_item_id (UUID).
- **create_a_linnworks_inventory_create_inventory_item_description** — Create descriptions for stock items in linnworks. Requires a JSON request body matching the upstream Inventory_CreateInventoryItemDescriptionsRequest schema (its fields are not enumerated in the reference). Returns an empty 204 response on success.
- **update_inventory_update_inventory_item_description_by_id** — Update stock item descriptions in Linnworks by sending the required JSON request body matching the upstream Inventory_UpdateInventoryItemDescriptionsRequest schema. Returns an empty 204 response on success.
- **delete_inventory_delete_inventory_item_description_by_id** — Delete stock item descriptions in Linnworks. Requires a JSON request body identifying the descriptions to remove. Returns an empty 204 response on success.
- **get_single_linnworks_inventory_get_stock_item_label_by_id** — Get stock item labels in Linnworks by search token. Returns an array of StockItemLabel objects; the label field structure is not enumerated in the upstream docs. Requires a JSON request body.
- **list_all_linnworks_inventory_get_batches_by_stock_item_ids** — Get batch information for a stock item across all locations in Linnworks. Returns each batch with BatchId, SKU, BatchNumber, ExpiresOn, SellBy, and an Inventory array of per-location records including Quantity, StockValue, and BinRack. Required: stockItemId.
- **get_single_linnworks_inventory_get_batch_inventory_by_id_by_id** — Get a batch's header and batch inventory in Linnworks by batch id. Returns: id. Required: the id of the batch to retrieve.
- **get_inventory_get_stock_item_batches_by_location_by_id** — Get batch information for a stock item at a specific Linnworks location. Sent as a POST request with a JSON body identifying the stock item id and location id; returns the batch info payload Linnworks defines for that item-location pair.
- **get_single_linnworks_inventory_get_batch_audit_by_id** — Get the audit trail for batches in linnworks. Returns the batch audit trail records for the requested batches; audit entry fields follow the upstream batch audit schema. Requires a request body identifying the batches to audit.
- **delete_inventory_delete_batch_inventory_in_bulk_by_id** — Delete batch inventory info in bulk in linnworks. Requires a JSON request body (upstream DeleteBatchInventoryInBulkRequest schema). Returns an empty 204 response on success.
- **delete_inventory_delete_batches_by_stock_item_id_by_id** — Delete the batches of a stock item in Linnworks. Requires a JSON request body identifying the stock item and the batches to remove. Returns an empty 204 response on success.
- **update_a_linnworks_inventory_update_batches_with_inventory_by_id** — Update batches and batch inventory info for stock items in linnworks. Send a Products payload with each item's SKU, Reference, Quantity, and per-location MultiLocationLevels. Returns an empty 204 response on success. Requires a JSON request body.
- **create_a_linnworks_inventory_create_batch** — Create new batches in Linnworks. Returns an empty 204 response on success. Requires a JSON request body; the payload fields follow the Linnworks CreateBatches request schema, see the Linnworks API reference for the full field list.
- **list_all_linnworks_inventory_has_stock_item_batches** — Check whether a stock item in Linnworks has batches. Returns a boolean result indicating whether the specified stock item has batches. Required: stockItemId (the stock item's unique identifier).
- **update_inventory_update_composite_parent_stock_level_by_id** — Update the stock level of a composite parent item in Linnworks. Requires a JSON request body matching the upstream Inventory_UpdateCompositeParentStockLevelRequest schema; the Linnworks docs do not expand its fields. Returns a bare integer (int32) result on success — the response carries no object fields.
- **update_a_linnworks_inventory_update_batch_date_by_id** — Update the dates (such as expiry and sell-by) on inventory stock item batches in linnworks. Returns a 200 JSON update response whose fields are defined by the upstream UpdateBatchDatesResponse schema and not enumerated in the available documentation. Requires a JSON request body.
- **list_all_linnworks_inventory_get_ebay_compatibility_lists** — List the eBay compatibility records for a stock item in Linnworks. Returns a collection of StockItemEbayCompatibility entries, each with an id and an attributes object carrying the item's compatibility details.
- **create_inventory_insert_update_ebay_compatibility_list** — Insert and update a list of eBay compatibility entries for stock items in Linnworks. Returns a 200 OK response body matching the upstream InsertUpdateEbayCompatibilityList response schema; the available docs do not enumerate its individual fields. Required: a JSON request body matching the upstream Inventory_InsertUpdateEbayCompatibilityListRequest schema.
- **delete_inventory_delete_ebay_compatibility_list_by_id** — Delete a list of eBay compatibility entries in linnworks via the Inventory API. Returns a JSON result object (upstream type DeleteEbayCompatibilityListResponse) whose fields are not enumerated in the linnworks docs. Requires a JSON request body identifying the compatibility list entries to remove.
- **list_all_linnworks_inventory_get_scrap_categories** — List the scrap categories configured for inventory scrapping in Linnworks. Returns each category record including its id and its category attributes as defined upstream. Requires no parameters.
- **create_a_linnworks_inventory_add_scrap_category** — Add scrap categories in linnworks. Returns an AddScrapCategoriesResponse object (200 OK). Required: a JSON request body matching the upstream AddScrapCategories request schema.
- **delete_a_linnworks_inventory_delete_scrap_category_by_id** — Delete scrap categories in linnworks. Requires a JSON request body identifying the scrap categories to remove. Returns an empty 204 response on success.
- **update_a_linnworks_inventory_update_scrap_category_by_id** — Update scrap categories in Linnworks using a JSON request body. Returns an empty 204 response on success.
- **get_single_linnworks_inventory_get_scrap_history_by_id** — Get scrap history in Linnworks, returning the historical record of stock scrapped from inventory. Returns the scrap history report as a 200 OK response; the response field set is not enumerated in the source docs. Requires a JSON request body (GetScrapHistoryRequest).
- **create_a_linnworks_inventory_add_scrap_item** — Add a scrap item in linnworks, recording stock as scrapped for the requested item. Returns the AddScrapItemResponse object on success — the upstream docs define it as a typed schema but do not enumerate its fields in the discovered source. Required: a JSON request body matching the upstream Inventory_AddScrapItemRequest schema.
- **create_a_linnworks_inventory_scrap_batched_item** — Scrap a batched stock item in Linnworks, writing off batch-tracked inventory. Requires a JSON request body matching the upstream Inventory_ScrapBatchedItemRequest schema. Returns the ScrapBatchedItemResponse object on success; its field-level breakdown is defined by that upstream schema.
- **create_a_linnworks_inventory_bulk_scrap_batched_item** — Scrap batched stock items in bulk without consumption in Linnworks by submitting a JSON request body. Returns an empty 204 response on success.
- **get_inventory_get_product_identifiers_by_stock_item_id_by_id** — Get the product identifiers for a stock item in Linnworks. Returns the identifiers record with its id; the remaining fields are defined by the upstream response schema and are not enumerated in the source docs, so consult the Linnworks API reference for the full field-level breakdown. Requires a request body identifying the stock item.
- **create_a_linnworks_inventory_add_product_identifier** — Add product identifiers to stock items in linnworks. Returns a batched response with the resulting product identifier records for each processed item. Requires a JSON request body.
- **update_a_linnworks_inventory_update_product_identifier_by_id** — Update product identifiers for stock items in Linnworks. Requires a JSON request body; its fields follow the upstream Inventory_UpdateProductIdentifiersRequest schema, which the available documentation does not enumerate. Returns an empty 204 response on success.
- **delete_a_linnworks_inventory_delete_product_identifier_by_id** — Delete product identifiers from stock items in linnworks. Requires a JSON request body identifying the product identifiers to remove; the individual body fields are not enumerated in the source documentation. Returns an empty 204 response on success.
- **list_all_linnworks_inventory_get_product_identifier_types** — List the product identifier types available in Linnworks inventory, e.g. to populate identifier pickers when creating or updating stock items. Returns each identifier type entry with its id and upstream-defined attributes; the entry fields are not enumerated in the Linnworks docs, so consult the Linnworks API reference for the field-level breakdown. Takes no parameters.
- **list_all_inventory_get_product_identifier_extended_types** — Get the available Product Identifier types in Linnworks with extended information, such as related sources and scanned-at-dispatch flags. Takes no parameters. Returns the extended type definitions with schema-defined fields per Linnworks' GetProductIdentifierExtendedResponse format.
- **get_inventory_get_scannable_product_identifiers_by_order_id** — Get the available product identifier types with extended information, such as related sources and scanned-at-dispatch status, for a set of Linnworks orders. Returns an opaque result object whose field set is not enumerated in the upstream docs. Required: OrderIds.
- **get_inventory_get_product_identifiers_bulk_by_stock_item_id** — Get product identifiers for multiple Linnworks stock items in a single call. Returns a map keyed by stock item id where each entry lists the identifiers found for that item, including their type, value, and site. Required: stock_item_ids.
- **create_a_linnworks_inventory_items_have_scannable_identifier** — Check whether linnworks inventory items have scannable identifiers. Returns the scannable-identifier check result for the submitted items; supply a JSON request body.
- **list_all_linnworks_inventory_get_channels** — List all channels configured in Linnworks inventory. Returns an array of channel records, each with an id and channel-specific configuration attributes. Takes no parameters.
- **list_all_linnworks_inventory_get_channels_by_sources** — Get channels by source in Linnworks. Returns an array of channel configuration records including their id and channel-specific attributes.
- **list_all_linnworks_inventory_get_extended_property_names** — Get all available extended property names for linnworks inventory items. Returns an array of extended property name strings, optionally narrowed by the propertyType filter.
- **list_all_linnworks_inventory_get_all_extended_property_names** — List the extended property names available across all types in Linnworks. Returns an object keyed by extended property type, each mapping to an array of property name strings. Takes no parameters.
- **list_all_linnworks_inventory_get_extended_property_types** — List the default extended property types in linnworks. Returns an array of extended property type name strings. Takes no parameters.
- **list_all_linnworks_inventory_get_package_groups** — List all package groups in Linnworks inventory. Returns an array of package group entries, each with a Key (package group id) and a Value (package group name). No parameters required.
- **list_all_linnworks_inventory_get_postal_services** — List all postal services in Linnworks. Returns an array of key/value entries: Key and Value (a GUID identifying the postal service).
- **create_a_linnworks_inventory_add_image_to_inventory_item** — Add an image to a stock item in linnworks. Returns a 200 OK response whose body fields are not enumerated in the available source documentation. A JSON request body carries the image details.
- **update_a_linnworks_inventory_update_inventory_item_field_by_id** — Update one or more field values on a Linnworks inventory (stock) item. Returns a 200 OK object with dynamic keys mapping updated field names to updated field value objects. Required: a JSON request body matching the upstream Inventory_UpdateInventoryItemFieldRequest schema; the endpoint takes no query parameters.
- **update_inventory_update_inventory_item_stock_field_by_id** — Update the stock field of an inventory item in linnworks and return the resulting stock level. Returns the updated stock level object with dynamic key-value fields (an object whose values are nested objects, per the upstream schema). Requires a JSON request body following the Inventory_UpdateInventoryItemStockFieldRequest schema.
- **update_a_linnworks_inventory_update_inventory_item_level_by_id** — Update stock level records for a stock item and any composite related items in linnworks. Returns the updated stock level records for the item and its composite related items. Requires a request body.
- **update_inventory_update_inventory_item_location_field_by_id** — Update a stock item's inventory location field in linnworks and return the resulting stock level records for that item. Returns a dynamic object of updated stock level records whose field names are not enumerated in the upstream docs. Requires a JSON request body (upstream schema: Inventory_UpdateInventoryItemLocationFieldRequest; its fields are not published in the discovered documentation).
- **list_all_linnworks_inventory_get_inventory_item_by_ids** — Get a Linnworks inventory item's product details by id. Returns the stock item's inventory record (StockItemInv), keyed by id. Required: id (UUID).
- **list_all_linnworks_inventory_get_inventory_items** — Get stock item details for a single inventory item in Linnworks, looked up by either its stock item id or SKU — stockItemId is used in preference when both are supplied, and the call throws if they don't relate to the same Linnworks item. Returns the stock item record keyed by its id together with the full item attributes.
- **list_all_linnworks_inventory_get_user_specific_views** — Get the user-specific inventory views stored in the linnworks database. Returns a list of inventory view records, each with an id and an attributes object holding the view's fields.
- **create_a_linnworks_inventory_create_user_specific_view** — Create a new user-specific inventory view in linnworks. Sends the required Inventory_CreateUserSpecificViewRequest JSON body. Returns an empty 204 response on success.
- **update_a_linnworks_inventory_update_user_specific_view_by_id** — Update an existing user-specific inventory view in linnworks. Returns an empty 204 response on success. Requires a JSON request body; the field-level schema is not documented upstream.
- **delete_a_linnworks_inventory_delete_user_specific_view_by_id** — Delete a user-specific view from the database in Linnworks. Returns an empty 204 response on success. Requires a JSON request body identifying the view to delete.
- **list_all_linnworks_inventory_get_pre_defined_views** — List the pre-defined (standard) inventory views in linnworks. Returns an array of view objects (InventoryView) with no caller-supplied parameters required.
- **list_all_linnworks_inventory_get_inventory_items_counts** — Get the total count of inventory items in linnworks. Returns a bare integer count (not an object). Optional: include_deleted, include_archived to also count deleted or archived items.
- **create_a_linnworks_inventory_add_inventory_item** — Add a new stock item in linnworks. Set MinimumLevel to null to use the Default Minimum Level from Settings; a JSON request body is required. Returns an empty 204 response on success.
- **create_a_linnworks_inventory_add_inventory_item_bulk** — Add up to 200 stock items to linnworks inventory in a single batch call. Returns a BatchedAPIResponse of Guid values identifying the processed stock items. Requires a JSON batch request body (marked required in the upstream spec); its item fields are not enumerated in the docs.
- **create_a_linnworks_inventory_duplicate_inventory_item** — Create a new Linnworks inventory item by duplicating an existing stock item. Returns an empty 204 response on success. Required: a JSON request body matching the upstream DuplicateInventoryItem request schema.
- **create_a_linnworks_inventory_archive_inventory_item** — Archive one or more inventory items in linnworks. The required JSON body carries the list of item IDs to archive alongside an empty list of regions. Returns an empty 204 response on success.
- **create_a_linnworks_inventory_unarchive_inventory_item** — Unarchive inventory items in Linnworks via POST /api/Inventory/UnarchiveInventoryItems. Requires a JSON request body (upstream schema Inventory_UnarchiveInventoryItemsRequest; its field-level structure is not enumerated in the available docs). Returns an empty 204 response on success.
- **list_all_linnworks_inventory_get_new_item_numbers** — Get the next unused SKU in Linnworks inventory. Returns the new item number as a plain JSON string. Takes no parameters.
- **update_a_linnworks_inventory_update_inventory_item_by_id** — Update a stock item in linnworks. This acts as a set endpoint — all stock item data is replaced, even if not provided in the request. Returns an empty 204 response on success. Supply StockItemId to identify the item, or ItemNumber when StockItemId is left empty.
- **delete_a_linnworks_inventory_delete_inventory_item_by_id** — Delete inventory items in linnworks; all associated information is unlinked/removed from each deleted stock item. Returns an empty 204 response on success. Requires a JSON request body (the upstream DeleteInventoryItems request object).
- **delete_a_linnworks_inventory_delete_inventory_item_bulk_by_id** — Delete inventory items in bulk in Linnworks; all associated information is unlinked and removed from each stock item. Accepts a JSON request body shaped by the upstream DeleteInventoryItemBulkRequest schema. Returns the batched delete result object with schema-specific fields defined by the upstream BatchedAPIResponse_DeleteInventoryItemBulkResponse schema; consult the Linnworks API reference for…
- **create_a_linnworks_inventory_adjust_templates_instant** — Adjust templates in Linnworks instantly via the inventory API. Requires a JSON request body. Returns an empty 204 response on success.
- **list_all_linnworks_inventory_get_inventory_item_channel_sk_us** — List the channel SKU link records for a Linnworks inventory item. Returns: a 200 OK array of StockItemChannelSKU records, each including the record id. Required: inventoryItemId (stockitem id, UUID).
- **create_inventory_batch_get_inventory_item_channel_sk_us** — Batch-get the channel SKUs for a list of Linnworks inventory items in one call. Returns an array of channel SKU response records as defined by the upstream StockItemChannelSkuResponse schema. Required: a JSON request body (Inventory_BatchGetInventoryItemChannelSKUsRequest) listing the inventory items to look up.
- **list_inventory_get_inventory_item_channel_sk_us_with_locations** — Use this call to retrieve all stock item channel sku's with location for a given channel sku RowId in Linnworks. Returns: LocationId, LocationName, IgnoreSync, MaxListedQuantity, EndWhenStock, StockPercentage, LastUpdate, UpdateStatus, SubmittedQuantity, ListedQuantity, fkRowId, RetryCount, and more.
- **update_a_linnworks_inventory_update_channel_mapping_by_id** — Update mappings between Linnworks inventory items and channel items — such as the Max Listed Quantity — by submitting a channel mapping update request body. Returns the batched update response (a BatchedAPIResponse of ChannelMappingUpdateInfo) reporting the outcome of each mapping update.
- **inventory_update_inventory_item_channel_sk_us_with_locations_upd** — Update Linnworks inventory channel SKU location properties, such as Max Listed Quantity. Requires a JSON request body describing the channel SKU location updates to apply. Returns an empty 204 response on success.
- **create_a_linnworks_inventory_create_channel_mapping** — Create mappings between Linnworks inventory items and channel items. Returns a batched API response containing channel mapping creation info for each submitted mapping. Mapping details are supplied in the JSON request body.
- **delete_inventory_delete_inventory_item_channel_sk_us_by_id** — Delete stock item channel SKUs in linnworks. Requires a JSON request body. Returns an empty 204 response on success.
- **list_all_inventory_is_inventory_item_channel_sku_linkeds** — Check whether a ChannelSKU is linked to an inventory item in linnworks. Returns a boolean — true when the ChannelSKU is linked, false otherwise.
- **create_a_linnworks_inventory_unlink_channel_listing** — Unlink a Linnworks inventory listing from its inventory item by sending an Inventory_UnlinkChannelListingRequest JSON body. Returns an empty 204 response on success.
- **list_all_linnworks_inventory_get_inventory_item_audit_trails** — Get the audit trail for a Linnworks stock item. Returns an array of audit trail entries, each with an id and schema-specific StockItemAuditTrail audit fields. Required: inventoryItemId (the stock item's unique identifier, UUID).
- **get_inventory_get_inventory_item_audit_trail_paged_by_id** — Get a paged list of Linnworks stock item audit trail entries filtered by request-body criteria. Returns the paged result envelope with Data (StockItemAuditTrail entries), PageNumber, EntriesPerPage, TotalEntries, and TotalPages. Requires a JSON request body matching the upstream Inventory_GetInventoryItemAuditTrailPagedRequest filter schema.
- **get_inventory_get_inventory_item_batch_information_by_id** — Get the batch information for a specific Linnworks inventory item. Returns an array of StockItemBatch records with BatchId, SKU, StockItemId, BatchNumber, InventoryTrackingType, ExpiresOn, SellBy, and per-location Inventory rows. Requires a request body matching the upstream Inventory_GetInventoryItemBatchInformationRequest schema; see the Linnworks API docs for its field-level definition.
- **get_inventory_get_inventory_item_batch_information_by_id_by_id** — Get batch information for multiple inventory items in Linnworks by their inventory item ids. Returns the batch-information response object defined by the upstream GetInventoryItemBatchInformationByIdsResponse schema on 200 OK (the Linnworks docs do not enumerate its fields). Requires a JSON request body matching the Inventory_GetInventoryItemBatchInformationByIdsRequest schema.
- **create_a_linnworks_inventory_has_stock_item_stock_level** — Check whether stock items in Linnworks have a stock level recorded. Posts a batch of products to the Inventory API for a stock-level check. Returns: Products, each with SKU, Reference, Quantity (sum of multi-location levels), and MultiLocationLevels (Tag, Quantity); shape mirrors Linnworks' multi-location inventory batch examples. Requires a JSON request body.
- **update_a_linnworks_inventory_update_batch_detail_by_id** — Update the batch details of a batched stock item in Linnworks, such as its batch number, expiry (ExpiresOn) and sell-by (SellBy) dates, and inventory tracking type. Returns an empty 204 response on success. Requires a JSON body identifying the batch to update (BatchId).
- **list_all_linnworks_inventory_get_inventory_item_images** — Get the images for a Linnworks inventory item. Returns an array of inventory item image records (StockItemImage objects). Supply either inventoryItemId or itemNumber — one is required; if both are sent, itemNumber is ignored.
- **get_single_linnworks_inventory_get_stock_item_ids_by_skus_by_id** — Resolve Linnworks inventory stock item ids from a list of SKUs. Returns a 200 OK JSON payload whose field-level shape is not enumerated in these docs (upstream schemas: Inventory_GetStockItemIdsBySKURequest / GetStockItemIdsBySKU). Requires a JSON request body.
- **get_single_linnworks_inventory_get_images_in_bulk_by_id** — Get images for multiple inventory items in Linnworks in a single bulk request. Returns the bulk image response object with fields defined by the upstream GetImagesInBulkResponse schema (not expanded in the available source). Requires a JSON request body.
- **create_a_linnworks_inventory_set_inventory_item_image_as_main** — Set the main image of a linnworks inventory item, marking the chosen image as the item's primary picture. Returns an empty 204 response on success. Required: a JSON request body identifying the inventory item and the image to set as main.
- **create_a_linnworks_inventory_upload_images_to_inventory_item** — Upload images from Uploader to a Linnworks stock item (inventory item). Returns a 200 response containing an array of picture-source objects (upstream PictureSource schema; the source does not enumerate its fields). Required: a request body matching the Linnworks upload-images-to-inventory-item request schema. This endpoint is rate limited to 150 calls per minute.
- **update_a_linnworks_inventory_update_image_by_id** — Update properties on inventory item images in linnworks by posting an UpdateImages JSON request body. Returns an empty 204 response on success.
- **delete_inventory_delete_images_from_inventory_item_by_id** — Delete images from Linnworks inventory items. Returns an empty 204 response on success. Requires a JSON request body defining the images to remove.
- **delete_inventory_delete_inventory_item_image_bulk_by_id** — Use this call to delete images from inventory items Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks. Returns: Results, TotalResults, ResultStatus.
- **list_all_linnworks_inventory_get_categories** — List all inventory categories configured in Linnworks. Returns a bare JSON array of category objects matching the upstream LinnworksCategory schema — the upstream reference does not enumerate the individual category fields. Requires no parameters.
- **list_all_linnworks_inventory_get_inventory_batch_types** — List the available inventory batch types in linnworks. Returns a map of batch type names to their integer identifiers. No required parameters.
- **create_a_linnworks_inventory_create_category** — Use this call to create new category in Linnworks. Returns: CategoryId, CategoryName, StructureCategoryId, ProductCategoryId.
- **update_a_linnworks_inventory_update_category_by_id** — Update the name of an existing inventory category in Linnworks. Returns an empty 204 response on success. Required: a JSON request body identifying the category and its new name.
- **delete_a_linnworks_inventory_delete_category_by_id_by_id** — Use this call to delete category by id in Linnworks.
- **list_all_linnworks_inventory_get_country_codes** — Use this call to get all country codes from ebay channel in Linnworks.
- **list_all_linnworks_inventory_get_countries** — Use this call to get list of all countries in Linnworks. Returns: CountryId, CountryName, CountryCode, Continent, Currency, CustomsRequired, TaxRate, AddressFormat, Regions, RegionsCount.
- **create_a_linnworks_inventory_create_country** — Use this call to create new countries in Linnworks.
- **update_a_linnworks_inventory_update_country_by_id** — Use this call to udpate countries in Linnworks.
- **delete_a_linnworks_inventory_delete_country_by_id** — Use this call to delete countries in Linnworks.
- **create_a_linnworks_inventory_create_country_region** — CreateCountryRegions in Linnworks. Returns: regions.
- **update_a_linnworks_inventory_update_country_region_by_id** — UpdateCountryRegions in Linnworks.
- **list_all_linnworks_inventory_get_stock_locations** — Use this call to get all stock locations in Linnworks. Returns: Address1, Address2, City, County, Country, ZipCode, IsNotTrackable, LocationTag, CountInOrderUntilAcknowledgement, FulfilmentCenterDeductStockWhenProcessed, IsWarehouseManaged, StockLocationId, and more.
- **list_all_linnworks_inventory_is_owned_stock_locations** — Checks whether a location is FBA or has an enabled inventory update import in Linnworks.
- **list_all_linnworks_inventory_get_inventory_item_locations** — Use this call to get stock item locations bin/rack in Linnworks. Returns: StockLocationId, LocationName, BinRack, StockItemId, StockItemIntId.
- **create_a_linnworks_inventory_add_item_location** — Use this call to add stock item locations bin/rack Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemBinRackNode in Linnworks.
- **update_a_linnworks_inventory_update_item_location_by_id** — Use this call to update stock item locations bin/rack Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemBinRackNode in Linnworks.
- **delete_a_linnworks_inventory_delete_item_location_by_id** — Use this call to delete stock item locations bin/rack Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemBinRackNode in Linnworks.
- **list_all_linnworks_inventory_get_inventory_item_compositions** — Use this call to get all StockItem Compositions in Linnworks. Returns: LinkedStockItemId, ItemTitle, SKU, Quantity, PurchasePrice, InventoryTrackingType, DimHeight, DimWidth, DimDepth, Weight, PackageGroupId, TaxRate, and more.
- **get_inventory_get_inventory_items_composition_by_id_by_id** — Use this call to get all StockItem Compositions in Linnworks. Returns: InventoryItemsCompositionByIds.
- **create_a_linnworks_inventory_create_inventory_item_composition** — Use this call to create compositions for stockItem Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks.
- **update_inventory_update_inventory_item_composition_by_id** — Use this call to update stockItem compositions Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks.
- **delete_inventory_delete_inventory_item_composition_by_id** — Use this call to delete stockItem compositions Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks.
- **get_inventory_get_inventory_item_extended_property_by_id** — Use this call to get stockitem Extended Properties in Linnworks. Returns: pkRowId, fkStockItemId, ProperyName, PropertyValue, PropertyType.
- **create_inventory_create_inventory_item_extended_property** — Use this call to create stockitem Extended Properties Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks.
- **update_inventory_update_inventory_item_extended_property_by_id** — Use this call to update stockitem Extended Properties Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks.
- **delete_inventory_delete_inventory_item_extended_property_by_id** — Use this call to delete stockitem Extended Properties Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks.
- **list_all_linnworks_inventory_get_inventory_item_titles** — Use this call to get stockitem Titles in Linnworks. Returns: pkRowId, Source, SubSource, Title, StockItemId, StockItemIntId.
- **create_a_linnworks_inventory_create_inventory_item_title** — Use this call to create stockitem Titles Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks.
- **update_a_linnworks_inventory_update_inventory_item_title_by_id** — Use this call to update stockitem Titles Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks.
- **delete_a_linnworks_inventory_delete_inventory_item_title_by_id** — Use this call to delete stockitem Titles Permissions Required: GlobalPermissions.Inventory.Stock.StockWrite.ChangeStockItemDetailsNode in Linnworks.
- **list_all_linnworks_inventory_get_suppliers** — Use this call to retrieve list of all Suppliers' names in Linnworks. Returns: pkSupplierID, SupplierName, ContactName, Address, AlternativeAddress, City, Region, Country, PostCode, TelephoneNumber, SecondaryTelNumber, FaxNumber, and more.
- **list_all_linnworks_inventory_get_supplier_details** — Use this call to retrieve details of one Supplier Permissions Required: GlobalPermissions.Inventory.InventorySettings.SuppliersNode in Linnworks. Returns: pkSupplierID, SupplierName, ContactName, Address, AlternativeAddress, City, Region, Country, PostCode, TelephoneNumber, SecondaryTelNumber, FaxNumber, and more.
- **create_a_linnworks_inventory_add_supplier** — Use this call to create a new supplier Permissions Required: GlobalPermissions.Inventory.InventorySettings.SuppliersNode in Linnworks. Returns: pkSupplierID, SupplierName, ContactName, Address, AlternativeAddress, City, Region, Country, PostCode, TelephoneNumber, SecondaryTelNumber, FaxNumber, and more.
- **update_a_linnworks_inventory_update_supplier_by_id** — Use this call to update supplier Permissions Required: GlobalPermissions.Inventory.InventorySettings.SuppliersNode in Linnworks.
- **delete_a_linnworks_inventory_delete_supplier_by_id** — Use this call delete Supplied by Id List of Supplier IDs Permissions Required: GlobalPermissions.Inventory.InventorySettings.SuppliersNode in Linnworks.
- **list_all_linnworks_inventory_get_stock_supplier_stats** — Use this call to retrieve report about "item supplier stat" in Linnworks. Returns: IsDefault, Supplier, SupplierID, Code, SupplierBarcode, LeadTime, PurchasePrice, MinPrice, MaxPrice, AveragePrice, AverageLeadTime, SupplierMinOrderQty, and more.
- **list_all_linnworks_inventory_get_stock_supplier_stats_bulks** — Use this call to retrieve report about "item supplier stat" in Linnworks. Returns: IsDefault, Supplier, SupplierID, Code, SupplierBarcode, LeadTime, PurchasePrice, MinPrice, MaxPrice, AveragePrice, AverageLeadTime, SupplierMinOrderQty, and more.
- **create_a_linnworks_listings_end_listings_pending_relist** — End eBay listings pending relist Permissions Required: GlobalPermissions.Settings.ListingConfiguratorsNode in Linnworks.
- **create_a_linnworks_listings_set_listing_strike_off_state** — Set eBay Listing Strike State Permissions Required: GlobalPermissions.Settings.ListingConfiguratorsNode in Linnworks.
- **list_all_linnworks_listings_gete_bay_configurators** — Use this call to get eBay configurators. A configurator hosts common details for listings such as listing type, return policy, payment methods, shipping info, attributes, listing categories, etc. Configurators offer an efficient way of creating listings in bulk that follow a common theme.The… in Linnworks. Returns: pkConfigId, ConfigName, EbayAccount, Site, OriginalConfigId, OriginalSite, IsOutOfStockFeatureEnabled, MaxQuantity, MinQuantity, MaxQuantityPerBuyer, IsMaxQuantityPerBuyerEnabled, ShowInInventory, and more.
- **list_all_linnworks_listings_get_all_ebay_configurators** — Use this call to get eBay configurators by source and subsource Permissions Required: GlobalPermissions.Settings.ListingConfigurators.GetListingConfiguratorsNode in Linnworks. Returns: SourceConfiguratorData.
- **create_a_linnworks_listings_createe_bay_configurator** — Use this call to create eBay configurators. A configurator hosts common details for listings such as listing type, return policy, payment methods, shipping info, attributes, listing categories, etc. Configurators offer an efficient way of creating listings in bulk that follow a common theme.The… in Linnworks.
- **update_a_linnworks_listings_updatee_bay_configurator_by_id** — Use this call to update eBay configurators. A configurator hosts common details for listings such as listing type, return policy, payment methods, shipping info, attributes, listing categories, etc. Configurators offer an efficient way of creating listings in bulk that follow a common theme. The… in Linnworks.
- **delete_a_linnworks_listings_deletee_bay_configurator_by_id** — Use this call to delete eBay configurators. A configurator hosts common details for listings such as listing type, return policy, payment methods, shipping info, attributes, listing categories, etc. Configurators offer an efficient way of creating listings in bulk that follow a common theme. The… in Linnworks.
- **get_single_linnworks_listings_gete_bay_template_by_id** — Use this call to return all created Ebay templates. Permissions Required: GlobalPermissions.Settings.ListingConfigurators.GetListingConfiguratorsNode in Linnworks. Returns: Items, TotalItems, CurrentPage, EntriesPerPage.
- **create_a_linnworks_listings_create_ebay_template** — Use this call to return a template based on the configurator setting you have requested. This allows you to see the template which can then be retuned to the ProcessEbayListing endpoint which will build the listing. Permissions Required:… in Linnworks. Returns: Items, TotalItems, CurrentPage, EntriesPerPage.
- **create_a_linnworks_listings_create_templates_from_view_in_bulk** — Use this call to create wireup to create templates in bulk Permissions Required: GlobalPermissions.Settings.ListingConfigurators.GetListingConfiguratorsNode in Linnworks.
- **list_all_linnworks_listings_get_ebay_listing_operations** — Use this call to get ebay listing bulk creation operations Permissions Required: GlobalPermissions.Settings.ListingConfigurators.GetListingConfiguratorsNode in Linnworks.
- **create_a_linnworks_listings_cancel_listing_bulk_operation** — Use this call to cancel ebay listing bulk creation operations Permissions Required: GlobalPermissions.Settings.ListingConfigurators.GetListingConfiguratorsNode in Linnworks.
- **create_a_linnworks_listings_processe_bay_listing** — Use this call to create templates in Linnworks and can also be used to push the template to a channel. This will create the template even if it returns null. This will also push the template to the channel depending on what the status is set as.
- **delete_a_linnworks_listings_delete_ebay_template_by_id** — Use this call to delete a Ebay template in Linnworks.
- **get_single_linnworks_listings_get_big_commerce_template_by_id** — Use this call to return all created Big Commerce templates in Linnworks. Returns: Items, TotalItems, CurrentPage, EntriesPerPage.
- **create_a_linnworks_listings_create_bigcommerce_template** — Use this call to return a template based on the configurator setting you have requested. This allows you to see the template which can then be retuned to the ProcessBigCommerceListing endpoint which will build the listing in Linnworks. Returns: Items, TotalItems, CurrentPage, EntriesPerPage.
- **create_a_linnworks_listings_process_bigcommerce_listing** — Use this call to create templates in Linnworks and can also be used to push the template to a channel. This will create the template even if it returns null. This will also push the template to the channel depending on what the status is set as.
- **list_all_linnworks_listings_get_bigcommerce_configurators** — Use this call to get all Bigcommerce configurators. A configurator hosts common details for listings such as listing type, return policy, payment methods, shipping info, attributes, listing categories, etc. Configurators offer an efficient way of creating listings in bulk that follow a common… in Linnworks. Returns: Attributes, OptionSetName, VarAttributes, UserAttributes, pkConfigid, Categories, Site, ConfigName, CategoryExtendedProperty, ManageStock, ShowInInventory, IsChanged, and more.
- **create_a_linnworks_listings_create_bigcommerce_configurator** — Use this call to create BigCommerce configurators. A configurator hosts common details for listings such as listing type, return policy, payment methods, shipping info, attributes, listing categories, etc. Configurators offer an efficient way of creating listings in bulk that follow a common… in Linnworks.
- **update_listings_update_bigcommerce_configurator_by_id** — Use this call to update BigCommerce configurators. A configurator hosts common details for listings such as listing type, return policy, payment methods, shipping info, attributes, listing categories, etc. Configurators offer an efficient way of creating listings in bulk that follow a common… in Linnworks.
- **delete_listings_delete_bigcommerce_configurator_by_id** — Use this call to delete BigCommerce configurators. A configurator hosts common details for listings such as listing type, return policy, payment methods, shipping info, attributes, listing categories, etc. Configurators offer an efficient way of creating listings in bulk that follow a common… in Linnworks.
- **delete_a_linnworks_listings_delete_bigcommerce_template_by_id** — Use this call to delete a Big Commerce template in Linnworks.
- **list_all_linnworks_locations_get_locations** — Use this call to retrieve a location and basic information about it from your Linnworks account. Returns: Address1, Address2, City, County, Country, ZipCode, IsNotTrackable, LocationTag, CountInOrderUntilAcknowledgement, FulfilmentCenterDeductStockWhenProcessed, IsWarehouseManaged, StockLocationId, and more.
- **create_a_linnworks_locations_add_location** — Use this call to add a new location in Linnworks.
- **update_a_linnworks_locations_update_location_by_id** — Use this call to update a location's name and/or details in Linnworks.
- **delete_a_linnworks_locations_delete_location_by_id** — Use this call to delete a location by its id in Linnworks.
- **get_single_linnworks_locations_get_warehouse_tot_e_by_id** — Gets list of tots for a specific location or find a specific tot depending on the request parameters. Specify tot id or tot barcode to find specific tot in the location or if nothing is specified or parameters are omitted, all tots for the location will be returned in Linnworks. Returns: Totes.
- **delete_a_linnworks_locations_delete_warehouse_tote_by_id** — Delete existing Tote from location Permissions Required: GlobalPermissions.Inventory.InventorySettings.LocationsNode in Linnworks. Returns: DeletedToteIds.
- **list_all_linnworks_macro_get_installed_macros** — Get a list of all macros and their related applications as installed on the users system Permissions Required: GlobalPermissions.Applications.MacroConfigurationNode in Linnworks. Returns: Macros.
- **list_all_linnworks_macro_get_macro_configurations** — Get all the macro configurations for the user account Permissions Required: GlobalPermissions.Applications.MacroConfigurationNode in Linnworks. Returns: MacroId, ApplicationName, MacroName, FriendlyName, Enabled, Started, Completed, Executing, CurrentState, MacroType, Parameters, Specification, and more.
- **get_single_linnworks_open_orders_get_view_stat_by_id** — GetViewStats in Linnworks. Returns: ViewId, ViewName, IsSystem, TotalOrders, LocationId, ExpiryDate, IsCalculating, ViewExists, LastRequested, UserManagement, OrderViewUserPreference, Owner, and more.
- **list_all_linnworks_open_orders_filter_not_processed_open_orders** — FilterNotProcessedOpenOrders in Linnworks. Returns: OrderIds.
- **linnworks_open_orders_search_orders_search** — SearchOrders in Linnworks. Returns: OpenOrders, ProcessedOrders.
- **get_single_linnworks_open_orders_get_open_order_id_by_id** — GetOpenOrderIds in Linnworks. Returns: PageNumber, EntriesPerPage, TotalEntries, TotalPages, Data. Required: ViewId, LocationId, EntriesPerPage.
- **get_single_linnworks_open_orders_get_open_order_by_id** — GetOpenOrders in Linnworks. Returns: ResultCountRemovedByPostFilter, PageNumber, EntriesPerPage, TotalEntries, TotalPages, Data. Required: ViewId, LocationId, EntriesPerPage.
- **list_all_linnworks_open_orders_get_identifiers** — Get all identifiers that are available to add to an order in Linnworks. Returns: IdentifierId, IsCustom, ImageId, ImageUrl, Tag, Name.
- **get_open_orders_get_identifiers_by_order_id_by_id** — Get all identifiers for a list of orderIds in Linnworks. Returns: fkOrderId, IdentifierId, IsCustom, ImageId, ImageUrl, Tag, Name.
- **create_a_linnworks_open_orders_save_identifier** — Create or update an order identifier in Linnworks. Returns: IdentifierId, IsCustom, ImageId, ImageUrl, Tag, Name.
- **delete_a_linnworks_open_orders_delete_identifier_by_id** — Delete an identifier. This will also remove the identifier from all orders that it's assigned to in Linnworks.
- **create_a_linnworks_open_orders_assign_order_identifier** — AssignOrderIdentifier in Linnworks. Returns: Changed, NotChanged.
- **create_a_linnworks_open_orders_unassign_order_identifier** — Remove an identifier from an order in Linnworks. Returns: Changed, NotChanged.
- **get_single_linnworks_open_orders_get_orders_low_fidelity_by_id** — Returns low fidelity view of open orders. The data is generally useful for very basic view or counters of what is in the open orders. Useful for finding orders quickly as it returns all scannable fields of the order and order items such as order ids, skus, barcodes etc. Permissions Required:… in Linnworks. Returns: Orders.
- **get_single_linnworks_open_orders_get_open_orders_detail_by_id** — Open order details by order ids. Not limited by the number of orders you can retrieve. This call is designed to return ONLY open orders, it is much faster than GetOrderDetail call Permissions Required: GlobalPermissions.OrderBook.ViewOrderDetailsNode in Linnworks. Returns: Orders.
- **create_a_linnworks_open_orders_assign_stock_to_order** — Assign Stock to Orders Permissions Required: GlobalPermissions.OrderBook.OpenOrdersNode in Linnworks. Returns: BatchActionResult.
- **delete_a_linnworks_open_orders_delete_assigned_stock_by_id** — Permissions Required: GlobalPermissions.OrderBook.OpenOrdersNode in Linnworks. Returns: BatchActionResult.
- **list_all_linnworks_open_orders_get_available_channels** — GetAvailableChannels in Linnworks. Returns: Channels.
- **get_single_linnworks_open_orders_get_order_item_indicator_by_id** — Permissions Required: GlobalPermissions.OrderBook.OpenOrdersNode in Linnworks. Returns: Items.
- **create_a_linnworks_open_orders_mark_ready_for_collection** — Permissions Required: GlobalPermissions.OrderBook.OpenOrdersNode in Linnworks. Returns: SuccessfulOrders, KeyedErrors.
- **list_all_linnworks_orders_get_order_details_by_reference_ids** — Retrieves a list of order details for a given order reference number, returns maximum of 50 orders. For eBay orders, if Sellling Manager Pro sales number is available the order can be retrived by this number Permissions Required: GlobalPermissions.OrderBook.ViewOrderDetailsNode in Linnworks. Returns: OrderId, NumOrderId, Processed, ProcessedDateTime, FulfilmentLocationId, GeneralInfo, ShippingInfo, CustomerInfo, TotalsInfo, ExtendedProperties, FolderName, Items, and more.
- **list_all_linnworks_orders_get_order_details_by_num_order_ids** — Retrieves the order detail for a given order numeric id. If not found empty class is returned. For working with open orders recommended to use OpenOrders/GetOpenOrdersDetails Permissions Required: GlobalPermissions.OrderBook.ViewOrderDetailsNode in Linnworks. Returns: OrderId, NumOrderId, Processed, ProcessedDateTime, FulfilmentLocationId, GeneralInfo, ShippingInfo, CustomerInfo, TotalsInfo, ExtendedProperties, FolderName, Items, and more.
- **list_all_linnworks_orders_get_order_by_ids** — Get the full order detail for a single linnworks order by its unique system order id (pkOrderId). Returns: OrderId, NumOrderId, Processed, ProcessedDateTime, FulfilmentLocationId, GeneralInfo (status, source, subsource, reference numbers, received date, notes), ShippingInfo (vendor, postal service, tracking number, package details), CustomerInfo (channel buyer name, delivery and billing address), TotalsInfo (subtotal, postage, tax, total, currency, payment method), ExtendedProperties, FolderName, Items (order lines with SKU, quantity, pricing, tax and stock levels), Notes, PaidDateTime and TaxId. linnworks recommends OpenOrders/GetOpenOrdersDetails for open orders. Rate limit 150 requests per minute. Required: pkOrderId.
- **get_single_linnworks_orders_get_orders_by_id_by_id** — Retrieves the order detail list for a list of order id identifiers (pkOrderId) For working with open orders recommended to use OpenOrders/GetOpenOrdersDetails Permissions Required: GlobalPermissions.OrderBook.ViewOrderDetailsNode in Linnworks. Returns: OrderId, NumOrderId, Processed, ProcessedDateTime, FulfilmentLocationId, GeneralInfo, ShippingInfo, CustomerInfo, TotalsInfo, ExtendedProperties, FolderName, Items, and more.
- **get_orders_get_order_packaging_calculation_by_id** — Retrieves order packaging, weight and dimension information with split packaging. The method can perform ad hoc recalculation and saving of any changes. Permissions Required: GlobalPermissions.OrderBook.ViewOrderDetailsNode in Linnworks. Returns: pkOrderID, nOrderId, fkPostalServiceId, fkCountryId, cCountry, ItemWeight, fkPackagingGroupId, fkPackagingTypeId, IsSplitPackaging, PackagingWeight, TotalWeight, TotalWidth, and more.
- **create_a_linnworks_orders_recalculate_single_order_packaging** — Designed to recalculate order packaging totals based on the object provided Permissions Required: GlobalPermissions.OrderBook.ViewOrderDetailsNode in Linnworks. Returns: pkOrderID, nOrderId, fkPostalServiceId, fkCountryId, cCountry, ItemWeight, fkPackagingGroupId, fkPackagingTypeId, IsSplitPackaging, PackagingWeight, TotalWeight, TotalWidth, and more.
- **create_orders_set_order_split_packaging_manual_overwrite** — Designed to save order split packaging after a manual override Permissions Required: GlobalPermissions.OrderBook.ViewOrderDetailsNode in Linnworks. Returns: pkOrderID, nOrderId, fkPostalServiceId, fkCountryId, cCountry, ItemWeight, fkPackagingGroupId, fkPackagingTypeId, IsSplitPackaging, PackagingWeight, TotalWeight, TotalWidth, and more.
- **create_a_linnworks_orders_set_order_packaging** — Save order packaging in linnworks that has already been calculated but not yet saved, or apply a manual packaging edit. Returns the saved order packaging record including pkOrderID, fkPackagingTypeId, TotalWeight, TotalWidth, TotalHeight, TotalDepth, Items, Bins, and DimMethod. Requires a request body containing the packaging payload to save.
- **get_orders_get_order_item_batchs_by_order_id_by_id** — Get the list of order item batch information for a specified Linnworks order. Returns batches with OrderItemBatchId, OrderItemRowId, Quantity, nested Batch details (BatchId, BatchNumber, ExpiresOn), DespatchUnitValue, and AssignmentType (AUTO or MANUAL). Required: pkOrderId (order id) in the request body.
- **get_orders_get_order_item_batches_by_order_id_by_id** — Get order item batch information for the specified orders in linnworks. Returns an OrderBatches array with pkOrderId, OrderId, and per-item Batches (BatchInventoryId, Quantity, and Batch details such as SKU, BatchNumber, and ExpiresOn). Required: pkOrderIds.
- **get_orders_get_all_available_order_item_batchs_by_order_id_by_id** — Get a list of available stock item batches for each order item of the specified Linnworks order. Returns: BatchId, SKU, BatchNumber, ExpiresOn, SellBy, and per-location Inventory records. Requires the order id in the request body.
- **create_a_linnworks_orders_create_order** — Create new orders in bulk in Linnworks. Returns the list of pkOrderId UUIDs for the orders that were saved; orders already marked as paid are skipped on save. Required: orders.
- **create_a_linnworks_orders_add_extended_property** — Add extended properties to a Linnworks order. Existing properties that match on name/value are skipped rather than updated. Returns ExtendedPropertiesInserted (count of properties added) and Errors (add-attempt failure messages).
- **create_orders_create_serialised_values_for_order_item** — Create serial data for the given order item rows in Linnworks: each entry in OrderItemSerialData identifies an OrderItemRowId and carries one collection of serial data per physical item being shipped (e.g. an order item with quantity 2 gets 2 collections), and values overwrite any existing serial data for that row. Required: OrderItemSerialData. Returns an empty 204 response on success.
- **get_orders_get_order_item_row_serial_values_by_order_id_by_id** — Get order item row serial information for a set of orders in linnworks by order id. Returns OrderItemRowSerialValuesByOrderIds, a dictionary keyed by order id whose values list OrderItemRowId and CorrelationSerials collections with Type and Value entries. Required: OrderIds (array of UUIDs, maximum 25 per request).
- **get_single_linnworks_orders_get_assigned_order_item_batch_by_id** — Get the batches assigned to order items in Linnworks. Returns: OrderItemBatchId, OrderItemRowId, Quantity, Batch (BatchId, SKU, BatchNumber, Inventory), DespatchUnitValue, and AssignmentType. Requires a JSON request body.
- **create_a_linnworks_orders_assign_order_item_batch** — Assign batches to linnworks order items. Returns an empty 204 response on success. Requires a JSON request body following Linnworks' Orders_AssignOrderItemBatchesRequest schema.
- **create_a_linnworks_orders_assign_stock_to_order** — Assign stock batches to a Linnworks order. Returns the resulting batch assignments as an array of OrderItemBatch objects with OrderItemBatchId, OrderItemRowId, Quantity, Batch, and AssignmentType. Required: request.
- **list_all_linnworks_orders_get_user_location_ids** — Get the location id configured for the user in linnworks order settings. Returns the location id as a UUID string (e.g. 00000000-0000-0000-0000-000000000000).
- **get_single_linnworks_orders_get_open_order_by_id** — Get a paged list of open orders in linnworks. Returns PageNumber, EntriesPerPage, TotalEntries, TotalPages, and a Data array of open order records including NumOrderId, GeneralInfo, ShippingInfo, CustomerInfo, TotalsInfo, and Fulfillment.
- **get_single_linnworks_orders_get_all_open_order_by_id** — Get the ids of all open orders in Linnworks as a single unpaginated list. Returns: array of open order id UUID strings (e.g. "00000000-0000-0000-0000-000000000000"). Requires a request body; no individual body fields are required.
- **get_orders_get_all_open_orders_between_index_by_id** — Get the ids of all open orders in Linnworks that fall between two index positions, with the current filters and sorting applied. Returns an array of open order id UUIDs.
- **create_a_linnworks_orders_set_labels_printed** — Mark a list of orders as label printed in Linnworks. Returns the affected order ids as an array of UUID strings.
- **create_a_linnworks_orders_set_invoices_printed** — Mark a list of orders as invoice printed in Linnworks; the operation cannot be executed on locked or parked orders. Returns the updated order ids as an array of UUID strings. Required: orderIds.
- **create_a_linnworks_orders_set_pick_list_printed** — Mark the given orders as pick list printed in Linnworks. Returns an empty 204 response on success. Requires orderIds (list of Linnworks order ids). Cannot be executed on locked or parked orders.
- **create_a_linnworks_orders_run_rules_engine** — Run the linnworks Rules Engine on open orders. Returns an array of UUID order identifiers the engine processed. Pass orderIds (list of order UUIDs) in the body; ruleId is optional — omit or null to run all rules.
- **list_all_linnworks_orders_get_order_item_compositions** — Get the composition detail of a specific order item in Linnworks. Returns the full OrderItem including ItemId, SKU, Title, Quantity, AvailableStock, PricePerUnit, and CompositeSubItems.
- **create_a_linnworks_orders_change_order_tag** — Change the tag for a list of linnworks orders. Tags 1-6 are custom tags, 7 sets a 'parked' status on the order, and null removes the tag. Returns the array of affected order ids (uuids).
- **list_all_linnworks_orders_get_available_folders** — List the linnworks folders that orders can be assigned to. Returns an array of folders, each with its pkFolderId (UUID) and FolderName.
- **create_a_linnworks_orders_set_available_folder** — Set the list of available folders that orders can be assigned to in linnworks. Returns the resulting array of folder objects with all documented fields: pkFolderId, FolderName. Required: folders.
- **create_a_linnworks_orders_assign_to_folder** — Assign a list of linnworks orders to a specific folder. Returns an array of order id UUIDs for the orders processed. Requires orderIds and folder. Cannot be executed on locked or parked orders.
- **create_a_linnworks_orders_unassign_to_folder** — Unassign a list of orders from a specific folder in linnworks. Returns an array of the affected order ids as UUID strings. Required: orderIds, folder. This operation cannot be executed on locked or parked orders.
- **list_all_linnworks_orders_get_order_xml_js_trees** — Get the order XML JSTree data received from the sales channel in Linnworks. Returns the order XML as a raw string (available as JSON or XML depending on the requested content type).
- **list_all_linnworks_orders_get_order_xmls** — Get the raw order XML received from the sales channel for an order in linnworks. Returns: Type.
- **create_a_linnworks_orders_change_shipping_method** — Change the shipping service (provided by a shipping courier) for a list of orders in Linnworks. Returns the affected order ids as an array of UUIDs. Required: orderIds, shippingMethod.
- **create_a_linnworks_orders_change_status** — Change the status of a list of Linnworks orders (status values: 0 = UNPAID, 1 = PAID, 2 = RETURN, 3 = PENDING, 4 = RESEND). Returns an array of uuid order ids for the orders the status was applied to. Requires a JSON request body.
- **create_a_linnworks_orders_lock_order** — Lock a list of orders in Linnworks. Requires a JSON request body matching the LockOrderRequest schema. Returns an empty 204 response on success.
- **delete_a_linnworks_orders_delete_order_by_id** — Delete a specific order in Linnworks. Requires a JSON request body identifying the order to delete. Returns an empty 204 response on success.
- **create_a_linnworks_orders_cancel_order** — Cancel a specific order in Linnworks. Returns a plain string result on success. Requires a request body identifying the order to cancel.
- **create_a_linnworks_orders_move_to_location** — Move a list of Linnworks orders to a specific location. Returns: SuccessfulOrders (the ids of the orders that were moved) and KeyedErrors (errors keyed by orderId). Requires LocationId and OrderIds.
- **create_a_linnworks_orders_clear_shipping_label_info** — Clear shipping label info for a list of Linnworks orders. Returns an array of key/value result pairs — key (the submitted order id) and value (its clear outcome) — one per order. Requires a JSON request body (Orders_ClearShippingLabelInfoRequest).
- **create_a_linnworks_orders_clear_invoice_printed** — Clear the invoice printed flag for a list of Linnworks orders. Returns an array of order UUID strings for the processed orders. Required: orderIds. This operation cannot be executed on locked or parked orders.
- **create_a_linnworks_orders_clear_pick_list_printed** — Clear the pick list printed flag for a list of orders in Linnworks. Returns an array of the processed order ids (uuid strings). Required: orderIds. Cannot be executed on locked or parked orders.
- **list_all_linnworks_orders_get_shipping_methods** — List the shipping methods available for orders in Linnworks. Returns an array of shipping method records, each with its id. No parameters are required.
- **list_all_linnworks_orders_get_packaging_groups** — List the packaging groups available in linnworks. Returns an array of packaging group objects (PackageGroup items) with fields defined by the upstream linnworks schema.
- **list_all_linnworks_orders_get_extended_properties** — Get the extended properties for a specific Linnworks order. Returns an array of extended property objects including RowId, Name, Value, Type, CreatedDate, and LastUpdatedDate. Required: orderId (UUID).
- **list_all_linnworks_orders_get_extended_property_types** — Get the available types of extended properties for orders in linnworks. Returns an array of extended property type name strings; no parameters required.
- **list_all_linnworks_orders_get_extended_property_names** — List the available types of extended properties for orders in Linnworks. Returns an array of strings, each naming one available extended property type. Takes no parameters.
- **create_a_linnworks_orders_set_extended_property** — Set the extended properties for a specific Linnworks order. Returns the saved extended properties, each with RowId, Name, Value, Type, CreatedDate, and LastUpdatedDate. Required: OrderId, ExtendedProperties.
- **list_all_linnworks_orders_get_batch_pilots** — List the available batch pilots in Linnworks. Returns an array of key-value pairs, each with Key (the pilot's GUID identifier) and Value (the pilot name). This call takes no parameters.
- **get_single_linnworks_orders_get_order_by_id** — Get a specific open order in Linnworks. Returns the full open-order object including OrderId, NumOrderId, Processed, GeneralInfo, ShippingInfo, CustomerInfo, TotalsInfo, Items, and Notes. Required: the order id, passed in the request body.
- **list_all_linnworks_orders_get_orders** — List open orders in Linnworks. Returns an array of full open-order objects including OrderId, NumOrderId, Processed, GeneralInfo, ShippingInfo, CustomerInfo, TotalsInfo, Items, and Notes. Filters are supplied in the request body.
- **list_all_linnworks_orders_get_order_audit_trails** — Get the audit trail entries for a linnworks order. Returns each entry's id plus its audit trail fields under attributes. Required: orderId.
- **get_single_linnworks_orders_get_order_audit_trails_by_id_by_id** — Get the audit trails for a list of linnworks orders in a single call. Returns the audit trail entries for the provided order ids; the upstream docs do not enumerate the entry fields. Required: order_ids (array of order id UUIDs).
- **list_all_linnworks_orders_get_order_notes** — Get the order notes for a specific linnworks order. Returns an array of order note objects including OrderNoteId, OrderId, NoteDate, Internal, Note, CreatedBy, and NoteTypeId. Required: orderId.
- **get_single_linnworks_orders_get_orders_note_by_id** — Get the notes for one or more linnworks orders in a single call. Returns a map of order id to an array of OrderNote objects with OrderNoteId, OrderId, NoteDate, Internal, Note, CreatedBy, and NoteTypeId. Requires a JSON request body.
- **list_all_linnworks_orders_get_order_note_types** — List the order note types available for orders in linnworks. Returns an array of note type records, each with an id and content-specific attributes. No parameters are required.
- **create_a_linnworks_orders_set_order_note** — Set the order notes for a specific order in linnworks. The provided list overwrites all existing notes — fetch current notes via GetOrderNotes and include them so none are lost. Requires a JSON request body per the upstream SetOrderNotes request schema. Returns an empty 204 response on success.
- **create_a_linnworks_orders_add_orders_note** — Add a new note to one or more Linnworks orders in a single batch call. Returns the AddOrdersNote operation result on success. Required: OrderIds.
- **list_all_linnworks_orders_get_order_relations** — Get order relations for an order in Linnworks. Returns a list of order relation records, each including its id and attributes (the upstream OrderRelation fields).
- **get_single_linnworks_orders_get_orders_relation_by_id** — Get order relations for a list of orders in Linnworks. Returns a map of order id to the array of OrderRelation objects for that order. Requires a JSON request body identifying the orders to fetch relations for (schema per the Linnworks Orders_GetOrdersRelationsRequest definition).
- **list_all_linnworks_orders_get_order_items** — List order items for a Linnworks order. Returns an array of order item records including SKU, ItemNumber, Title, Quantity, PricePerUnit, CostIncTax, stock levels, and BinRacks. Filter by orderId and fulfilmentCenter.
- **list_all_linnworks_orders_get_open_order_items_suppliers** — List the item suppliers for a specific open order in linnworks. Returns an array of Key/Value UUID pairs, each linking an order item to its supplier. Required: orderId.
- **create_a_linnworks_orders_add_order_item** — Add an item to a specific order in linnworks. Returns the update result object (UpdateOrderItemResult) with id and schema-specific result fields (attributes). Line pricing is optional: PricePerUnit defaults to the stock item retail price, DiscountPercentage to 0, TaxRatePercentage to the stock item tax rate, and TaxInclusive to true. Requires a JSON request body identifying the order and item.
- **create_a_linnworks_orders_add_order_service** — Add a service to an order in Linnworks. Returns the UpdateOrderItemResult object confirming the order change; the Linnworks reference does not enumerate the fields of this result object.
- **update_a_linnworks_orders_update_order_item_by_id** — Update an order item on a Linnworks order. Requires a JSON request body and returns the order item update result object with vendor-defined fields.
- **create_a_linnworks_orders_remove_order_item** — Remove an item from a Linnworks order. Returns an UpdateOrderItemResult object describing the outcome of the removal. Requires a JSON request body identifying the order and the item to remove.
- **list_all_linnworks_orders_get_countries** — List the available countries in linnworks. Returns an array of country records, each with an id and attributes; the attribute fields follow linnworks' OrderCountry schema. Takes no parameters.
- **list_all_linnworks_orders_get_payment_methods** — Get the payment methods available in Linnworks. Returns: Name, Price, Currency. No required parameters.
- **list_all_orders_get_default_payment_method_id_for_new_orders** — Get the default payment method for new direct orders in linnworks. Returns a single UUID string identifying the payment method id. No parameters are required.
- **create_orders_set_default_payment_method_id_for_new_order** — Set the default payment method applied to new direct orders in Linnworks. Returns an empty 204 response on success. Requires a JSON request body (referenced upstream as Orders_SetDefaultPaymentMethodIdForNewOrderRequest; its fields are not enumerated in the source docs).
- **create_a_linnworks_orders_set_payment_method** — Set the available payment methods in Linnworks. Returns an array of payment method objects. Requires a request body. Rate limited to 150 requests per minute.
- **create_a_linnworks_orders_create_new_order** — Create an empty draft order in Linnworks (for fully-specified orders, use the CreateOrders call instead). Returns the new open order including OrderId, NumOrderId, ReferenceNum, Status, ShippingInfo, TotalsInfo, and Items.
- **list_all_linnworks_orders_get_draft_orders** — List draft orders in Linnworks. Returns an array of draft order ids as UUID strings (one id per draft order, e.g. 00000000-0000-0000-0000-000000000000). No parameters required.
- **create_a_linnworks_orders_complete_order** — Complete a specific order in linnworks. Returns a plain string acknowledgement on success rather than a structured object. Requires a CompleteOrder request body.
- **create_a_linnworks_orders_split_order** — Split a Linnworks order into multiple separate orders. Returns an array of the resulting order objects, each with OrderId, NumOrderId, GeneralInfo, TotalsInfo, and Items. Requires a JSON request body.
- **create_a_linnworks_orders_merge_order** — Merge a list of orders in Linnworks into a single new open order. Returns the merged open order object (id plus its upstream-defined OpenOrder fields). Requires a JSON request body identifying the orders to merge.
- **create_a_linnworks_orders_process_order** — Process a specific order in linnworks, advancing it through the processing workflow. Returns a process-order result object (ProcessOrderResult) describing the outcome of the operation. Required: a JSON request body matching the upstream Orders_ProcessOrderRequest schema; the discovered source references that schema by name without enumerating its fields, so consult the linnworks API reference for…
- **create_a_linnworks_orders_process_order_required_batch_scan** — Update a Linnworks order with the batch numbers scanned during process order (for items with batch number scanning required, including composite children); this overwrites any existing batch assignment for those items. Requires the batch scan request body, with batches supplied for every scan-required item. Returns an empty 204 response on success.
- **create_a_linnworks_orders_process_orders_in_batch** — Process a list of orders in Linnworks in one batch call. Returns an array of per-order ProcessOrderResult objects. Requires a JSON batch request payload; its field structure is defined by the upstream Orders_ProcessOrdersInBatchRequest schema.
- **create_a_linnworks_orders_process_fulfilment_centre_order** — Process orders associated with a Fulfilment Centre in Linnworks. Returns the process-order result object; the Linnworks API reference does not enumerate its fields. Requires a JSON request body.
- **create_a_linnworks_orders_set_order_general_info** — Update the general info of a specific order in linnworks. Requires a JSON request body matching linnworks' SetOrderGeneralInfoRequest schema. Returns an empty 204 response on success.
- **create_a_linnworks_orders_set_order_shipping_info** — Update the shipping info of a specific order in linnworks by posting a JSON request body. Returns an UpdateTotalsResult object reflecting the order's recalculated totals after the update.
- **create_a_linnworks_orders_set_order_customer_info** — Update the customer info of a specific order in linnworks, supplying the buyer's shipping and billing details for that order. Returns the recalculated order totals including Subtotal, PostageCost, Tax, TotalCharge, TotalDiscount, and Currency. Required: a JSON request body.
- **create_a_linnworks_orders_set_order_totals_info** — Update the totals info (subtotal, postage cost, tax, total charge, currency) of a specific order in linnworks. Required: a JSON body following the upstream Orders_SetOrderTotalsInfoRequest schema (its fields are not enumerated in the API docs). Returns an empty 204 response on success.
- **create_a_linnworks_orders_validate_coupon** — Validate a coupon in linnworks. Returns a coupon validation result (upstream CouponValidationResult) with the record's id and an attributes object holding the validation fields. Required: a JSON request body matching the upstream Orders_ValidateCouponRequest schema.
- **create_a_linnworks_orders_add_coupon** — Add a coupon to a specific order in linnworks. Returns the order-item update result object (UpdateOrderItemResult). Requires a JSON request body matching the upstream Orders_AddCouponRequest schema.
- **update_a_linnworks_orders_update_billing_addrese_by_id** — Update the billing address of a specific order in Linnworks. Sends a JSON request body and returns an empty 204 response on success.
- **create_a_linnworks_orders_set_additional_info** — Overwrite the existing order item additional info in Linnworks. Returns an empty 204 response on success.
- **update_a_linnworks_orders_update_additional_info_by_id** — Update the additional info of a specific order item in Linnworks. Sends a JSON request body defined upstream by the Orders_UpdateAdditionalInfoRequest model (field-level shape not enumerated in the source docs). Returns an empty 204 response on success. Requires a JSON request body.
- **list_all_linnworks_orders_get_order_views** — List the open order views saved in linnworks. Returns an array of UserOrderView view records, each including its pkViewId identifier.
- **get_single_linnworks_orders_get_order_view_by_id** — Get a specific open order view in linnworks by id. Returns the UserOrderView record including its pkViewId identifier. Required: pkViewId.
- **create_a_linnworks_orders_save_order_view** — Update an open order view in Linnworks. Returns an empty 204 response on success. Requires a JSON request body; its fields are defined by the upstream Orders_SaveOrderViewRequest schema.
- **list_all_linnworks_orders_customer_look_ups** — Look up possible customer addresses in linnworks based on a search. Returns matching customer address records, each with an id and address attributes whose exact fields follow the upstream CustomerAddress schema.
- **list_all_linnworks_orders_get_linked_items** — List the items linked to a stock item in Linnworks, looked up by itemId (the item's pkStockItemId). Returns an array of LinkedItem records; the source documentation does not enumerate their fields.
- **update_a_linnworks_orders_update_link_item_by_id** — Update the linked item for a Linnworks order. Sends a JSON request body (Orders_UpdateLinkItemRequest, field-level contract defined in Linnworks' API reference) and returns an empty 204 response on success. Requires a JSON request body.
- **create_a_linnworks_orders_create_new_item_and_link** — Create a new order item in linnworks and link it to a specific stock item. Returns the id of the newly created item as a UUID string. Requires a JSON request body conforming to linnworks' Orders_CreateNewItemAndLinkRequest schema.
- **list_all_linnworks_orders_get_order_packaging_splits** — Get possible order splits by packaging for a Linnworks order. Returns an array of packaging-split proposals (OrderPackagingSplit objects; the split structure is defined upstream in the Linnworks API reference).
- **create_a_linnworks_orders_set_order_packaging_split** — Split a linnworks order by packaging, applying the packaging split computed for the order. Returns an UpdateTotalsResult with the recalculated order totals. Requires a packaging split request body.
- **get_orders_get_open_order_id_by_order_or_reference_id_by_id** — Get the open order id in linnworks by reference number or order number. Returns the open order id as a UUID string (e.g. 00000000-0000-0000-0000-000000000000). Requires a JSON request body.
- **create_a_linnworks_orders_process_order_by_order_or_reference_id** — Process a Linnworks order by its order id or reference id. Requires a JSON request body identifying the order to process. Returns the order processing result object; Linnworks' published documentation does not enumerate the response fields for this endpoint.
- **get_orders_get_open_orders_by_item_barcode_by_id** — Get open orders in Linnworks by order item barcode. Returns an array of key/value entries, each pairing an OrderSummary object (Key) with a string (Value). Requires a JSON request body (upstream schema: Orders_GetOpenOrdersByItemBarcodeRequest).
- **list_all_linnworks_picking_get_all_picking_wave_headers** — List all pickwave headers in Linnworks. Returns the GetPickingWaveHeadersResponse object; the source documentation does not enumerate its fields.
- **list_all_linnworks_picking_get_my_picking_wave_headers** — List pickwave headers assigned to the current user in linnworks. Returns the GetPickingWaveHeadersResponse pickwave header collection; optional state, locationId, and detailLevel filters narrow the results (all states returned when state is omitted).
- **list_all_linnworks_picking_get_all_picking_waves** — List all pickwaves in Linnworks. Returns pickwave entries including their PickwaveId, state, and locationId.
- **list_all_linnworks_picking_get_my_picking_waves** — List the pickwaves for the current user in Linnworks. Returns: PickwaveId, State, LocationId.
- **list_all_linnworks_picking_get_picking_waves** — Get a specific pickwave in Linnworks by id. Returns the pickwave record including its id and its upstream schema-defined pickwave fields.
- **update_a_linnworks_picking_update_picking_wave_item_by_id** — Update one or more pickwave items in Linnworks. Returns the updated pickwave response (upstream GetPickingWavesResponse schema — its field-level properties are not enumerated in the available documentation). Requires a JSON request body (the UpdatePickingWaveItem request payload).
- **update_a_linnworks_picking_update_picking_wave_header_by_id** — Update a pickwave header in Linnworks by posting a PickingWaveUpdateRequest JSON body. Returns 200 with the updated pickwave data defined by the upstream GetPickingWavesResponse schema (shared with GetPickingWave); the available source does not expand its field list.
- **create_a_linnworks_picking_generate_picking_wave** — Generate a new picking wave in Linnworks. Returns a GeneratePickingWaveResponse object; the upstream documentation does not enumerate its fields. Requires a PickingWaveGenerate JSON request body.
- **create_a_linnworks_picking_check_allocatable_to_pickwave** — Check whether Linnworks order ids can be added to a pickwave. Returns the allocatability check results under attributes (the upstream CheckAllocatableToPickwaveResponse, per supplied order id). Requires a JSON request body listing the Linnworks order ids to check.
- **list_all_linnworks_picking_get_pickwave_users_with_summaries** — List Linnworks pickwaves with per-user summary entries, including dummy entries with a PickwaveId of 0 for users permitted to complete pickwaves but with no wave currently assigned. Returns: PickwaveId, plus an attributes object holding the remaining upstream summary fields.
- **delete_a_linnworks_picking_delete_orders_from_picking_wave_by_id** — Remove one or more orders from a pickwave in linnworks. Returns a 200 OK result body whose exact fields follow the upstream DeleteOrdersFromPickingWavesResponse schema (not expanded in the available source). Requires a JSON request body per the upstream Picking_DeleteOrdersFromPickingWavesRequest schema; the endpoint takes no other inputs.
- **list_all_linnworks_picking_get_item_binracks** — List the alternative binrack locations where a requested stock item can be found in Linnworks, excluding the location already suggested for picking. Returns a list of place records; the field-level shape is defined by the upstream GetItemBinracksResponse schema and is not enumerated in the available documentation. All query parameters (stockItemId, stockLocationId, currentBinRackSuggestion,…
- **update_picking_update_picking_wave_item_with_new_binrack_by_id** — Update the batch/binrack allocation for a Linnworks pickwave item. Returns the refreshed picking wave data in Linnworks' GetPickingWavesResponse format (same payload as the GetPickingWave endpoint). Only applicable to pickwave items that carry batch information.
- **update_a_linnworks_picking_update_picked_item_delta_by_id** — Update the batch/binrack allocation for an allocated pickwave item in Linnworks. Returns the resulting pickwave data for the affected wave rather than the item alone. Only applicable to pickwave items with batch information.
- **list_all_picking_get_pickingwave_despatch_data_by_locations** — Get picking wave despatch data by location in Linnworks. Returns despatch data records including id and upstream-defined attributes (PickingWaveDespatchData).
- **list_all_linnworks_postal_services_get_postal_services** — List the Linnworks postal services available to the user, including information on the channels and couriers linked to each service. Returns an array of postal service objects with their linked channel and courier details. No caller-supplied parameters are required.
- **create_a_linnworks_postal_services_create_postal_service** — Create a new postal service in Linnworks, adding it to the shipping database. Returns the created postal service object including its id and its upstream-defined service attributes. Requires a JSON request body conforming to the upstream CreatePostalService request schema.
- **update_a_linnworks_postal_services_update_postal_service_by_id** — Update an existing postal service in linnworks. Requires a JSON request body matching the upstream PostalServices_UpdatePostalServiceRequest schema; its field-level contract is not enumerated in the source. Returns an empty 204 response on success.
- **delete_a_linnworks_postal_services_delete_postal_service_by_id** — Delete an existing postal service from Linnworks. Returns an empty 204 response on success. Requires a JSON request body (upstream schema: PostalServices_DeletePostalServiceRequest); the source documentation does not enumerate its fields.
- **list_all_linnworks_postal_services_get_channel_links** — List channel service link information for linnworks postal services. Returns channel service link records including id and attributes.
- **list_all_linnworks_post_sale_get_cancellation_options** — Validate whether a channel cancellation can be submitted for a given Linnworks order. Returns the upstream CancellationOptions object for the order. Required: orderId (UUID).
- **create_a_linnworks_post_sale_create_cancellation** — Create a cancellation in Linnworks: further validates the request, creates the cancellation, and submits it to the sales channel where requested. Returns the ValidatedCancellation result object (schema-defined upstream; the reference does not enumerate its fields). Requires the PostSale cancellation request body (PostSale_CreateCancellationRequest).
- **create_print_service_create_pd_ffrom_job_force_template_stock_in** — Create a PDF file from a print job request via the linnworks Print Service, using a forced template for stock-in labels. Returns a CreatePDFResult object with schema-defined fields; the field-level shape is defined upstream.
- **create_print_service_create_pd_ffrom_job_force_template** — Create a PDF file from a print job request in linnworks. Returns the CreatePDFResult object with fields describing the generated PDF. Requires the print job request body.
- **print_service_create_pd_ffrom_job_force_template_with_quantities** — Create a PDF file of Stock Item labels from a print job request in Linnworks PrintService. Returns the CreatePDFResult object generated for the print job. Requires the print job request body defined by the PrintService_CreatePDFfromJobForceTemplateWithQuantitiesRequest schema.
- **create_a_linnworks_print_service_print_template_preview** — Generate a PDF preview of a specific print template in linnworks. Requires a JSON request body defining the template preview. Returns the generated PDF result object with an opaque, upstream-defined shape.
- **list_all_linnworks_print_service_get_template_lists** — List the print templates available in linnworks. Returns an array of template headers, each identified by id with template-specific attributes.
- **list_all_linnworks_print_service_vp_get_printers** — List the virtual printers configured for your linnworks account. Returns an array of virtual printer records, each with an id and printer-specific attributes; Linnworks does not document the VirtualPrinter fields in detail.
- **list_all_linnworks_print_service_get_users_for_printer_configs** — List the Linnworks users available for printer configuration. Returns an array of user records (PermissionsUser objects), including their id. Only super admins receive the full list; non-super-admins get only their own user record. Takes no parameters.
- **print_service_create_return_shipping_labels_pdf_with_sk_us_creat** — Create a PDF file of return shipping labels for a single order in linnworks. Returns the PDF generation result (CreatePDFResult) with details of the generated PDF. Requires a JSON request body matching the upstream CreateReturnShippingLabelsPDFWithSKUs request schema.
- **create_print_service_create_return_shipping_labels_pdf** — Create a PDF file of return shipping labels for a single Linnworks order. Returns the generated PDF result object; the upstream source does not enumerate its fields. Requires a JSON request body identifying the order.
- **list_all_linnworks_print_zone_get_all_print_zones** — List all print zones configured in linnworks. Returns a 200 OK print-zone collection response whose per-item field set is not enumerated in the available Linnworks documentation. Takes no parameters.
- **create_a_linnworks_processed_orders_refund_free_text** — Create or update a free text refund on a processed order in Linnworks; can also change the refund amount of a pending manual refund. Returns an array of refund records (id) whose remaining fields follow Linnworks' RefundInfo schema. Requires a JSON request body (upstream schema ProcessedOrders_RefundFreeTextRequest); verify any automated refunds are valid before calling.
- **create_a_linnworks_processed_orders_refund_shipping** — Create a shipping refund for a processed order in Linnworks. Check the order's refund options first to confirm a shipping refund is possible. Requires a ProcessedOrders_RefundShippingRequest JSON body; returns an array of RefundInfo records describing the refunds created. Rate limited to 150 calls per minute.
- **create_processed_orders_mark_manual_refunds_as_actioned** — Mark pending manual refunds in Linnworks as actioned, updating them from the pending state. Accepts a JSON request body and returns an empty 204 response on success.
- **create_a_linnworks_processed_orders_refund_service** — Refund one or more services on a processed Linnworks order. Returns an array of refund information (RefundInfo) entries for the refunded services. Requires a JSON request body identifying the order and services to refund; validate that any automated refunds are valid before calling.
- **create_processed_orders_validate_complete_order_refund** — Check whether an automated full-order refund is possible for a Linnworks processed order. Returns a validation result object (upstream ValidationResult schema; its fields are not enumerated in the available source). Requires a JSON request body matching the upstream ValidateCompleteOrderRefundRequest schema.
- **list_all_linnworks_processed_orders_get_refunds_options** — Get the refund options for a linnworks processed order — which manual and automated refund types are possible for that order. Returns the refund options record (id, attributes). Required: pkOrderId (the order's id).
- **list_all_linnworks_processed_orders_get_refundable_service_items** — Get the list of service items on a Linnworks processed order that are eligible for a refund. Returns each service item's id and attributes, with the item fields defined by the upstream ServiceItem schema.
- **list_all_linnworks_processed_orders_get_total_refunds** — Get the total value of refunds against a processed order in linnworks. Returns the ExistingRefundTotal record with schema-specific fields (id, attributes) defined upstream. Required: pkOrderId.
- **create_a_linnworks_processed_orders_is_refund_valid** — Validate whether the refunds in a given return set are valid in Linnworks. Returns a Linnworks ValidationResult object; the available Linnworks documentation does not enumerate its fields. Requires a JSON request body matching Linnworks' ProcessedOrders_IsRefundValidRequest schema.
- **list_processed_orders_is_refund_validation_required_by_order_ids** — Check whether a linnworks order requires refund validation before refunds or returns/exchanges with refund components can proceed. Returns a boolean flag (true when validation is required for the given order). Required: pkOrderId (the order id to check).
- **list_all_linnworks_processed_orders_get_channel_refund_reasons** — List the valid channel refund reasons for a given order in linnworks; these reasons are needed when making channel refunds. Returns an array of channel refund reason entries for the order identified by pkOrderId.
- **list_all_linnworks_processed_orders_get_returns_exchanges** — List the returns, exchanges and resends recorded against a processed order in linnworks. Returns the basic list of return info entries for the order, one per return, exchange or resend. Supply the order id as pkOrderId (UUID).
- **list_all_linnworks_processed_orders_get_return_items_infos** — Get all items on a Linnworks processed order together with their return and resend quantities, used to calculate how many items have already been returned. Returns an array of per-item return-info objects (Linnworks OrderItemReturnInfo schema), one entry for each item on the order. Required: pkOrderId.
- **list_all_linnworks_processed_orders_get_return_order_infos** — Get basic information about a processed order in linnworks — source, subsource, and address as seen on the Returns/Refunds screens. Returns: source, subsource, address. Required: pkOrderId.
- **list_all_linnworks_processed_orders_get_order_infos** — Get detailed header-level information about a processed order in linnworks. Returns the processed order (ProcessedOrderWeb) object including its pkOrderId. Required: pkOrderId (the order id).
- **get_processed_orders_get_order_tracking_ur_l_by_id** — Get the tracking URLs for processed orders in Linnworks, looked up per order by vendor and tracking number. Returns the tracking URL details for the supplied orders. Requires a JSON request body identifying the orders to look up.
- **linnworks_processed_orders_search_processed_orders_search** — Search processed orders in linnworks by posting search criteria. Returns the matched processed order results with the schema-defined fields of the upstream SearchProcessedOrdersResponse. Requires a JSON request body.
- **linnworks_processed_orders_search_processed_orders_pageds_search** — Search for processed orders in Linnworks via a paged search. Returns paged results with page_number, entries_per_page, total_entries, total_pages and data.
- **create_a_linnworks_processed_orders_download_orders_to_csv** — Download processed orders to CSV in Linnworks. Returns the DownloadOrdersToCSVResponse download result object; the upstream docs do not enumerate its fields. Requires a JSON request body.
- **create_a_linnworks_processed_orders_add_return_category** — Create a new return category in linnworks. Returns the created order return category object. Requires a request body with the return category details.
- **create_a_linnworks_processed_orders_rename_return_category** — Rename an existing return category in Linnworks. Returns an empty 204 response on success. Requires a JSON request body per the upstream ProcessedOrders_RenameReturnCategoryRequest schema identifying the category to rename and its new name.
- **delete_a_linnworks_processed_orders_delete_return_category_by_id** — Delete an existing return category in linnworks. Returns an empty 204 response on success. Requires a request body identifying the return category to delete.
- **list_all_linnworks_processed_orders_get_processed_relatives** — List the related orders for a processed order in linnworks. Returns an array of related-order (ProcessedOrderRelation) records; the upstream docs do not enumerate the fields of each record. Required: pkOrderId (the order id, UUID).
- **list_all_linnworks_processed_orders_get_package_splits** — Get split packaging information for a processed order in Linnworks. Returns an array of SplitPackaging records for the order. Required: pkOrderId (the order id, UUID).
- **list_all_linnworks_processed_orders_get_processed_audit_trails** — Get the audit trail for a processed order in Linnworks. Returns: entries (the audit trail records for the order, upstream type AuditEntry). Required: pkOrderId (the order id, UUID).
- **list_processed_orders_get_processed_order_extended_properties** — Get order-level extended properties for a processed order in Linnworks. Returns a list of extended properties with RowId, Name, Value, Type, CreatedDate, and LastUpdatedDate. Filter by pkOrderId (the order id, UUID).
- **list_all_linnworks_processed_orders_get_return_categories** — List the return categories configured in linnworks, used for refunds, resends and exchanges. Returns the collection of return category records including each category's id and attributes. No required parameters.
- **list_all_linnworks_processed_orders_get_processed_order_notes** — Get the order notes for a processed order in linnworks. Returns a list of notes with OrderNoteId, OrderId, NoteDate, Internal, Note, CreatedBy, and NoteTypeId. Required: pkOrderId.
- **create_a_linnworks_processed_orders_add_order_note** — Add a new note to a processed order in linnworks. Returns the UUID id of the created order note. Requires a JSON request body (upstream schema ProcessedOrders_AddOrderNoteRequest).
- **create_a_linnworks_processed_orders_change_order_note** — Edit an existing order note on a processed order in Linnworks. Returns an empty 204 response on success. Requires a JSON request body with the order note details.
- **delete_a_linnworks_processed_orders_delete_order_note_by_id** — Delete an existing note on a linnworks processed order. Requires a JSON request body identifying the note to delete. Returns an empty 204 response on success.
- **create_a_linnworks_processed_orders_create_exchange** — Create an exchange for a processed order in Linnworks. Returns an array of return/exchange info records as defined by Linnworks' ReturnInfo schema. Requires an exchange request body.
- **create_a_linnworks_processed_orders_create_resend** — Create a resend for a processed order in linnworks. Returns a 200 OK response as an array of ReturnInfo objects describing the created resend. Requires a JSON request body following the CreateResend request schema.
- **create_a_linnworks_processed_orders_create_full_resend** — Create a full resend for a processed order in linnworks. A JSON request body is required (ProcessedOrders_CreateFullResendRequest); the source docs reference this schema but do not enumerate its fields. Returns 200 OK with an array of ReturnInfo objects for the created resend.
- **list_all_linnworks_processed_orders_get_refunds** — List refund order items for a Linnworks processed order. Returns an array of refund records including the record id and the refund-specific detail fields in attributes. Supply pkOrderId (the order's UUID primary key) to select the order.
- **list_all_linnworks_processed_orders_check_order_fully_returneds** — Check whether a Linnworks order was fully returned. Returns a boolean flag (true when the order was fully returned). Required: pkOrderId (UUID of the order).
- **linnworks_purchase_order_search_purchase_orders_2_s_search** — Search Linnworks purchase orders by parameters such as date of purchase, status, and reference number. Returns a paged result of purchase order headers: Data (purchase order header records), PageNumber, EntriesPerPage, TotalEntries, and TotalPages. All search parameters are supplied in the request body.
- **linnworks_purchase_order_search_purchase_orders_search** — Search Linnworks purchase orders by parameters such as date of purchase, status, or reference number. Returns a paged result of purchase order headers; the header fields follow Linnworks' Search_PurchaseOrdersResult schema. Requires a JSON request body of search parameters (upstream PurchaseOrder_Search_PurchaseOrdersRequest).
- **create_a_linnworks_purchase_order_create_purchase_order_initial** — Create an initial purchase order in linnworks; the purchase order is created in pending status and stock items can be added to it afterwards. Returns: id. Requires a JSON request body whose fields are defined by the PurchaseOrder_Create_PurchaseOrder_InitialRequest schema.
- **update_purchase_order_update_purchase_order_header_by_id** — Update a linnworks purchase order header. Only allowed while the order's status is not Delivered. Returns the modified/recalculated purchase order header with its updated status and recalculated totals.
- **create_purchase_order_modify_purchase_order_items_bulk** — Modify Linnworks purchase order item lines in bulk: delete, add, and update item lines in one call, triggering a purchase order totals recalculation. Returns the recalculated purchase order result defined by the Modify_PurchaseOrderItems_BulkResponse schema. Required: a JSON request body matching the PurchaseOrder_Modify_PurchaseOrderItems_BulkRequest schema.
- **create_a_linnworks_purchase_order_add_purchase_order_item** — Add a stock item line to an existing PENDING purchase order in linnworks. Returns the recalculated purchase order header and the modified purchase order item line after the addition. Items can only be added to PENDING purchase orders.
- **update_purchase_order_update_purchase_order_item_by_id** — Update a purchase order item line in linnworks (quantity, cost, pack size, pack quantity); the order must be in PENDING status. Returns the recalculated purchase order header and the modified purchase order item line. Requires a JSON request body (upstream schema PurchaseOrder_Update_PurchaseOrderItemRequest; its field names are not enumerated in the discovered source).
- **delete_purchase_order_delete_purchase_order_item_by_id** — Delete a purchase order item line from a PENDING purchase order in linnworks. Returns the recalculated purchase order header for the parent order (id, plus the upstream header fields in attributes). Item lines can only be removed while the order is PENDING. The required JSON body must identify the order and the item line to delete, per the upstream request schema.
- **get_purchase_order_get_purchase_orders_with_stock_item_by_id** — Get the Linnworks purchase order ids that contain undelivered stock items. Returns an array of purchase order ids (UUID strings). Requires a JSON request body.
- **get_single_linnworks_purchase_order_get_purchase_order_by_id** — Get a single linnworks purchase order by id — the order header and its item lines in one call. Returns: id. Required: id.
- **get_purchase_order_get_purchase_order_note_by_id** — Get the purchase order notes for a purchase order in Linnworks. Returns a JSON array of purchase order note objects (upstream PurchaseOrderNote schema — the note's individual fields are not enumerated in the available documentation). Requires a JSON request body per the upstream PurchaseOrder_Get_PurchaseOrderNoteRequest schema.
- **create_a_linnworks_purchase_order_export_purchase_order** — Export a Linnworks purchase order. Sends the purchase order to export in the required JSON request body and returns an opaque DownloadResponse descriptor whose fields the upstream docs do not enumerate. Requires a purchase order identifier in the request body.
- **create_a_linnworks_purchase_order_add_purchase_order_note** — Add a note to a purchase order in linnworks. Returns the created purchase order note object. Requires a JSON request body describing the note.
- **delete_purchase_order_delete_purchase_order_note_by_id** — Delete a note from a purchase order in linnworks. Returns a bare integer result value (200 OK). Requires a JSON request body identifying the note to delete — the upstream field names are not enumerated in the API docs.
- **create_a_linnworks_purchase_order_change_purchase_order_status** — Change the status of a purchase order in linnworks (PENDING to OPEN, OPEN or PARTIAL to DELIVERED), updating Due (OnOrder) stock levels accordingly. Returns the updated purchase order header record including its id and attributes. The purchase order identifier and target status are supplied in the JSON request body.
- **purchase_order_deliver_purchase_item_all_except_batch_items_crea** — Deliver all non-batch-tracked purchase order items in a linnworks purchase order (PENDING orders only). Returns a 200 response with the recalculated purchase order header and the delivered item lines. Requires a JSON request body following the PurchaseOrder_Deliver_PurchaseItemAll_ExceptBatchItemsRequest schema.
- **create_purchase_order_deliver_purchase_items_with_quantity** — Deliver purchase order items with specified quantities in Linnworks. Returns an empty 204 response on success. Requires a JSON request body; the upstream docs reference a dedicated request schema but do not enumerate its fields.
- **create_a_linnworks_purchase_order_deliver_purchase_item_all** — Deliver all remaining items of a linnworks purchase order in one call, updating item quantity, cost, pack size, and pack quantity — works on PENDING orders only. Returns: purchase_order_header (recalculated header), purchase_order_item_line. Requires a JSON request body.
- **create_a_linnworks_purchase_order_deliver_purchase_item** — Deliver a purchase order item in linnworks, adjusting the current stock level by the delivered quantity; once all items are delivered the purchase order status changes to delivered. Returns a DeliverPurchaseOrderItemResponse describing the delivery outcome. Requires a JSON request body identifying the purchase order item and the total number of delivered items.
- **get_purchase_order_get_purchase_order_status_list_by_id** — Get the list of available purchase order statuses in linnworks. Returns an array of status strings: PENDING, OPEN, PARTIAL, and DELIVERED. Requires a JSON request body (send an empty object).
- **delete_a_linnworks_purchase_order_delete_purchase_order_by_id** — Delete a purchase order in Linnworks. Returns an empty 204 response on success. Requires a JSON request body identifying the purchase order to delete (per the upstream PurchaseOrder_Delete_PurchaseOrderRequest schema).
- **get_purchase_order_get_purchase_order_audit_by_id** — Get the audit log for a purchase order in linnworks. Returns an array of purchase order audit records in descending order, capped at 1000 records. Requires a request body identifying the purchase order.
- **get_purchase_order_get_purchase_order_extended_property_by_id** — Get all extended properties for a purchase order in linnworks. Returns: id. Requires a JSON request body (its fields are not enumerated in the upstream docs).
- **create_purchase_order_add_purchase_order_extended_property** — Add extended properties to a purchase order in Linnworks. Property names must be unique per purchase order, and a purchase order can hold at most 50 extended properties before the call errors. Requires a JSON request body with the extended-property details to add. Returns the upstream Add_PurchaseOrderExtendedPropertyResponse object whose field-level shape is defined by Linnworks and not…
- **update_purchase_order_update_purchase_order_extended_property** — Update an existing extended property on a linnworks purchase order by id. Returns an empty 204 response on success. Requires the id of the extended property to update in the request body; throws an error if the supplied id doesn't exist or the property name duplicates an existing one.
- **delete_purchase_order_delete_purchase_order_extended_property** — Delete extended property items by id from a Linnworks purchase order. Requires a JSON request body identifying the extended property item id(s) to delete. Returns an empty 204 response on success.
- **get_purchase_order_get_additional_cost_type_by_id** — Get the additional cost types configured for purchase orders in linnworks. Returns the collection of cost types as a JSON body; individual field definitions are not enumerated in the API documentation. Requires a JSON request body.
- **create_a_linnworks_purchase_order_add_additional_cost_type** — Add a new additional cost type for purchase orders in Linnworks. Requires a JSON request body. Returns the Add_AdditionalCostTypesResponse payload; its fields are not enumerated in the available documentation.
- **update_purchase_order_update_additional_cost_type_by_id** — Update an additional cost type in linnworks purchase orders. Returns a 200 OK response defined by the upstream Update_AdditionalCostTypesResponse schema; the discovered source does not enumerate its fields. Required: a JSON request body matching the upstream PurchaseOrder_Update_AdditionalCostTypesRequest schema.
- **delete_purchase_order_delete_additional_cost_type_by_id** — Delete an additional cost type in linnworks. Returns an empty 204 response on success.
- **create_a_linnworks_purchase_order_modify_additional_cost** — Modify purchase order additional costs in linnworks by adding new lines, updating, or deleting existing ones. Returns the modified additional cost list — each record identified by a unique identifier — plus the purchase order header with its total recalculated. Required: a JSON request body carrying the purchase order's modified additional cost lines.
- **get_single_linnworks_purchase_order_get_additional_cost_by_id** — Get the additional costs of a purchase order in Linnworks. Returns the additional-cost response object; the source does not document its field-level shape. Required: a JSON request body selecting the purchase order.
- **create_purchase_order_modify_additional_cost_allocation** — Modify the additional cost allocation items of a purchase order in Linnworks. Returns a Modify_AdditionalCostAllocationResponse object on success; its field-level shape is defined by that upstream schema and is not enumerated in the integration docs. Requires a JSON request body matching the PurchaseOrder_Modify_AdditionalCostAllocationRequest schema.
- **create_a_linnworks_purchase_order_modify_payment_statement** — Modify purchase order payment statements in linnworks: add new lines, update or delete existing ones. Returns the modified list of payment statement records, each identified by a unique identifier. Requires a JSON request body.
- **get_single_linnworks_purchase_order_get_payment_statement_by_id** — Get the payment statements of a purchase order in linnworks. Returns the payment statement record including its id and upstream-defined statement attributes. Requires a JSON request body.
- **create_a_linnworks_purchase_order_find_stock_item** — Find a stock item in Linnworks by its SKU or supplier code, passing the lookup criteria in the JSON request body. Returns: id.
- **get_single_linnworks_purchase_order_get_delivered_record_by_id** — Get delivered item records for a specific purchase order in linnworks. Returns the delivered-records response for that PO; the record fields are defined by the upstream Get_DeliveredRecords response schema and are not enumerated in the source documentation. Requires a JSON request body identifying the purchase order.
- **get_single_linnworks_purchase_order_get_emails_sent_by_id** — Get the records of emails sent for a specific purchase order (PO) in Linnworks. Returns the upstream Get_EmailsSentResponse body on 200 OK — the available Linnworks documentation does not enumerate its fields. Requires a JSON request body matching the PurchaseOrder_Get_EmailsSentRequest schema (required; its fields are likewise not enumerated in the discovered docs).
- **get_single_linnworks_purchase_order_get_email_csv_file_by_id** — Get the download URL of the CSV file for a specific purchase order in linnworks. Returns the CSV file download link for that purchase order; response fields are not broken out in the upstream documentation. Sends a JSON request body identifying the target purchase order.
- **create_a_linnworks_purchase_order_create_p_os_from_inventory** — Create purchase orders from inventory in linnworks. Requires a JSON request body matching the upstream PurchaseOrder_CreatePOsFromInventoryRequest schema. Returns the CreatePOsFromInventory response object, whose field set is defined by the upstream CreatePOsFromInventoryResponse schema.
- **get_single_linnworks_returns_refunds_get_refund_option_by_id** — Get refund options for an order in linnworks. Returns the channel-specific types of refund that can be applied to the given order. Requires a JSON request body specifying the target order.
- **get_returns_refunds_get_actionable_refund_header_by_id** — List actionable booked refund headers in linnworks. Returns a paged refund-header payload whose fields are not enumerated in the upstream documentation. Requires a JSON request body.
- **get_returns_refunds_get_processed_or_acked_error_refund_header** — Get a paged list of processed or acknowledged error refund headers in Linnworks. Sends a JSON request body and returns a 200 OK paged refund-headers response; the upstream request and response schemas are not enumerated in the available API reference. No required parameters.
- **get_returns_refunds_get_rma_headers_by_order_id_by_id** — Get all RMA (return merchandise authorization) headers associated with a given order ID in Linnworks. Returns the RMA header records for that order in a response payload whose fields are defined by the upstream API (GetRMAHeadersByOrderIdResponse); the JSON request body carries the order identifier per the upstream request schema.
- **get_returns_refunds_get_refund_headers_by_order_id_by_id** — Get all refund headers for a given order ID in linnworks. Returns the refund header records associated with that order. Required: order ID, passed in the request body.
- **get_returns_refunds_get_refund_lines_by_header_id_by_id** — Get the refund lines for a refund in Linnworks by its refund header ID. Returns the refund lines belonging to the given refund header. Requires a JSON request body carrying the refund header ID.
- **create_a_linnworks_returns_refunds_create_refund** — Create a refund in Linnworks for approval. Returns the created refund record with its id and the upstream-defined response attributes. Requires a JSON refund request body.
- **update_a_linnworks_returns_refunds_update_refund_by_id** — Update an existing refund in Linnworks. Returns the UpdateRefundResponse object for the updated refund; the upstream reference does not enumerate the response fields. Required: a JSON request body matching the upstream ReturnsRefunds_UpdateRefundRequest schema.
- **create_a_linnworks_returns_refunds_acknowledge_refund_error** — Acknowledge the error responses recorded against a given refund header in linnworks. Returns: a 200 OK acknowledgement result (upstream AcknowledgeRefundErrorsResponse). Requires a JSON request body identifying the refund header whose errors should be acknowledged (upstream ReturnsRefunds_AcknowledgeRefundErrorsRequest).
- **create_a_linnworks_returns_refunds_acknowledge_rma_error** — Acknowledge all error responses for a given RMA header in linnworks. Returns the acknowledgement response (id, attributes; the Linnworks docs define the AcknowledgeRMAErrorsResponse schema but do not enumerate its fields). Requires a JSON request body per the upstream ReturnsRefunds_AcknowledgeRMAErrorsRequest schema.
- **create_a_linnworks_returns_refunds_action_refund** — Send a refund to the selling channel for actioning in Linnworks. Returns the actioning result object from Linnworks (upstream ActionRefundResponse schema); its fields are defined by that component schema and depend on the channel integration, so they are not enumerated here. Requires a JSON request body carrying the refund actioning payload (upstream ReturnsRefunds_ActionRefundRequest schema).
- **delete_a_linnworks_returns_refunds_delete_refund_by_id** — Delete all not-yet-processed refund lines from a refund header in linnworks, removing it from the Actionable Refunds screen; the header row is deleted once no lines remain. Returns an opaque DeleteRefundResponse acknowledgement on success. Required: a JSON request body identifying the refund header (per ReturnsRefunds_DeleteRefundRequest).
- **delete_a_linnworks_returns_refunds_delete_rma_by_id** — Delete unprocessed, non-error lines from a Linnworks RMA header, removing the booking from the RMA Bookings screen (the header row is deleted once no lines remain). Requires a JSON request body identifying the RMA header. Returns the upstream DeleteRMAResponse body; its fields are not enumerated in the docs.
- **get_single_linnworks_returns_refunds_get_return_option_by_id** — Get the channel-specific return and refund options that can be applied to a given order in Linnworks. Returns the GetReturnOptionsResponse object — channel-specific option details whose fields vary by sales channel and are not enumerated in the available documentation. Requires a JSON request body identifying the order.
- **get_returns_refunds_get_actionable_rma_header_by_id** — List actionable RMA headers from linnworks Returns & Refunds. Returns a paged list of booked RMA header records; the upstream response schema is not field-enumerated in the linnworks documentation. Requires a JSON request body.
- **get_returns_refunds_get_processed_or_acked_error_rma_header** — Get a paged list of processed or acknowledged error RMA headers in Linnworks, i.e. returns/exchanges bookings that were either fully processed or acknowledged after an error. Returns a paged response of RMA header records from the Returns & Exchanges module.
- **create_a_linnworks_returns_refunds_create_rma_booking** — Create an RMA booking in Linnworks. Returns: id. Requires a JSON request body; the field-level shape comes from the upstream CreateRMABooking request schema.
- **update_a_linnworks_returns_refunds_update_rma_booking_by_id** — Update an RMA booking in Linnworks. Returns the upstream UpdateRMABookingResponse object with HTTP 200 (the source documentation does not enumerate its fields). Required: a JSON request body matching the upstream UpdateRMABookingRequest schema.
- **create_a_linnworks_returns_refunds_action_rma_booking** — Accept a booked return or exchange (book it in) in Linnworks. Returns the ActionRMABooking confirmation response on 200 OK; Linnworks does not document the field-level shape of this response. Required: a JSON request body.
- **list_all_linnworks_returns_refunds_get_refund_orders** — List all refund order items for every order in linnworks. Returns an array of refund order records identified by their id; the upstream documentation references a RefundOrder schema but does not enumerate its fields.
- **list_all_returns_refunds_get_booked_returns_exchange_orders** — List all booked returns/exchange orders in linnworks. Returns the booked order records including their id and the remaining schema-defined order fields under attributes.
- **delete_a_linnworks_returns_refunds_delete_booked_order_by_id** — Delete a booked returns/exchange order in linnworks. Requires a JSON request body identifying the order to remove. Returns an empty 204 response on success.
- **create_a_linnworks_returns_refunds_action_booked_order** — Action the booked returns/exchange items for a given order ID in linnworks. Returns an empty 204 response on success. Requires a JSON request body; returns for batched items must be booked in manually.
- **delete_a_linnworks_returns_refunds_delete_booked_item_by_id** — Delete a booked returns/exchange order item in linnworks. Requires a JSON request body identifying the booked item to delete (upstream schema: ReturnsRefunds_DeleteBookedItemRequest). Returns an empty 204 response on success.
- **create_a_linnworks_returns_refunds_refund_order** — Refund a Linnworks order by its order ID. Sends the refund request as a JSON body and returns an empty 204 response on success. Requires a JSON body identifying the order to refund.
- **list_all_linnworks_returns_refunds_get_warehouse_locations** — List all warehouse locations configured in Linnworks for returns and refunds. Returns an array of warehouse location records; the endpoint takes no request parameters.
- **create_a_linnworks_returns_refunds_edit_booked_item_info** — Edit a booked exchange/return item in linnworks Returns & Refunds. Requires a JSON request body following the upstream EditBookedItemInfoRequest schema. Returns an empty 204 response on success.
- **delete_returns_refunds_delete_pending_refund_item_by_id** — Delete a pending refund item in Linnworks Returns & Refunds, removing it from the refund queue. Requires a JSON body (upstream DeletePendingRefundItemRequest schema; the docs do not enumerate its fields). Returns an empty 204 response on success.
- **list_all_linnworks_returns_refunds_get_total_refunds** — Get the total refundable amount of an order in linnworks. Returns the amount as a bare number (double); pass the order's fkOrderId as a UUID query parameter.
- **list_all_linnworks_returns_refunds_search_returns_refunds_pageds** — Search Linnworks returns, refunds, and cancellations history matching date-range and text-search criteria. Returns a paged result: PageNumber, EntriesPerPage, TotalEntries, TotalPages, and Data (the matching history records). Date range is capped at 3 months; up to 200 entries per page.
- **list_all_linnworks_returns_refunds_create_returns_refunds_csvs** — Create a CSV file of the linnworks returns/refunds search results for download. Returns the CSV file content as a string. Maximum search date range (from to to) is 3 months.
- **list_all_linnworks_returns_refunds_get_search_types** — List the valid search types in linnworks needed to search processed orders for returns and refunds. Returns an array of search field records, each exposing id and attributes.
- **list_all_linnworks_rules_engine_get_evaluator_types** — List the valid evaluator types for the linnworks Rules Engine. Returns an array of evaluator descriptors, each identifying a valid evaluator and the group it belongs to; per-descriptor fields follow the upstream EvaluatorDescriptor schema, which the Linnworks reference does not enumerate. Takes no additional parameters.
- **list_all_linnworks_rules_engine_get_evaluation_fields** — List the valid evaluation fields for a given rule type in the Linnworks Rules Engine. Returns field descriptors, each with an id and attributes describing one evaluation field.
- **list_all_linnworks_rules_engine_get_options** — Get the valid option values for a given field in the linnworks Rules Engine. Returns an array of option strings for the requested field and rule type.
- **get_single_linnworks_rules_engine_get_multi_option_by_id** — Get the valid options for a set of Linnworks rules engine fields (and, if relevant, keys) in a single call — the batch counterpart of GetOptions. Requires a JSON request body identifying the fields to look up. Returns a JSON array of MultiOptionResponse entries, one per requested field.
- **list_all_linnworks_rules_engine_get_key_options** — Get the list of valid keys for a given field in the linnworks Rules Engine. Returns an array of valid key option strings. Pass type (Test or Orders) and fieldName to specify the rule type and field to look up.
- **get_single_linnworks_rules_engine_get_multi_key_option_by_id** — Get the list of valid keys for a set of fields in the linnworks Rules Engine. Returns a list of key-option entries, one for each requested field. Requires a JSON request body identifying the fields to look up.
- **list_all_linnworks_rules_engine_get_rules** — List all rules in the Linnworks Rules Engine. Returns an array of basic rule header records (RuleHeaderBasic), each including its id.
- **list_all_linnworks_rules_engine_get_rules_by_types** — List rules engine rules of a given type in linnworks. Returns an array of basic rule header records with id and attributes (upstream RuleHeaderBasic fields, not enumerated in the docs). Filter by type (Test or Orders).
- **list_all_linnworks_rules_engine_get_rule_condition_nodes** — Get the condition nodes belonging to a rule in Linnworks, excluding the condition items. Returns an array of rule condition node records; the upstream documentation references the RuleConditionHeader schema without enumerating its fields.
- **list_all_linnworks_rules_engine_get_condition_webs** — Get details about a specific condition in the Linnworks Rules Engine. Returns the basic condition header record, including its pkConditionId and the remaining ConditionHeaderBasic attributes defined upstream. Required: pkConditionId.
- **list_all_linnworks_rules_engine_get_action_types** — List the valid action types available for rules in the linnworks Rules Engine. Returns an array of action type information records (upstream RuleActionInformation); the source does not enumerate their fields. Only the orders rule type is currently supported.
- **create_a_linnworks_rules_engine_create_new_condition** — Create a new condition in the Linnworks rules engine. Returns the created condition as a RuleConditionHeader object. Required: a JSON request body matching the upstream RulesEngine_CreateNewConditionRequest schema (see the Linnworks API reference for its field-level shape).
- **create_a_linnworks_rules_engine_save_condition_change** — Update a condition and its condition items in the linnworks Rules Engine via SaveConditionChanges. Returns an empty 204 response on success. Requires a JSON body matching the upstream RulesEngine_SaveConditionChangesRequest schema.
- **list_all_linnworks_rules_engine_check_condition_name_exists** — Check whether a condition name already exists at a specific level in the linnworks rules engine. Returns a boolean — true when the name is already in use. fkConditionId must be supplied when checking a sub-condition level, and excludeConditionId excludes the condition being renamed from the check.
- **list_all_linnworks_rules_engine_get_actions** — Get details of a Linnworks Rules Engine action identified by the pkActionId query parameter. Returns the action object including its id and its action-specific attributes from the upstream RuleActionResponse schema.
- **list_all_linnworks_rules_engine_get_action_options** — List valid options for a given Rules Engine action in linnworks. Returns a map of action type keys to arrays of option records. Required: type (one of the supported action types, e.g. AssignShippingService, ExecuteMacro, AddNoteToOrder).
- **update_a_linnworks_rules_engine_update_action_by_id** — Update a rules engine action in linnworks. Returns an empty 204 response on success. Required: pkActionId and fkConditionId in the request body, both carrying their unchanged original values.
- **create_a_linnworks_rules_engine_add_action** — Add a new action to a condition node in the linnworks rules engine. Returns the created action with its pkActionId and fkConditionId. Requires a JSON request body describing the action to add (upstream CreateActionRequest schema).
- **delete_a_linnworks_rules_engine_delete_action_by_id** — Delete an action from a rule in the linnworks Rules Engine. Returns an empty 204 response on success. Required: id (of the action to delete).
- **delete_a_linnworks_rules_engine_delete_condition_by_id** — Delete a condition in the linnworks Rules Engine together with its subconditions and actions. Returns an empty 204 response on success. Requires a JSON request body matching the upstream RulesEngine_DeleteConditionRequest schema identifying the condition to delete.
- **create_a_linnworks_rules_engine_swap_condition** — Swap the sort order of two conditions belonging to the same parent in the linnworks Rules Engine. Returns an empty 204 response on success. Requires a JSON request body (the upstream SwapConditions request schema); its exact fields are not expanded in the discovered docs.
- **list_all_linnworks_rules_engine_get_required_fields_by_rule_ids** — Get the fields and keys used by a given rule in the linnworks Rules Engine. Returns the rule's field and key definitions under attributes, following the upstream RulesFields schema (individual field keys are not enumerated in the source docs). Required: pkRuleId.
- **list_all_linnworks_rules_engine_get_required_fields_by_types** — Get the list of fields and keys used by a given rule type in the linnworks Rules Engine. Returns the field and key definitions for the requested rule type. Requires type (the rule type: Test or Orders).
- **create_a_linnworks_rules_engine_test_evaluate_rule** — Test-evaluate a Linnworks rules engine rule against a set of test values without running it on live orders. Returns the rule evaluation result object (upstream RuleEvaluationResult) produced from the supplied test values. Requires a JSON request body matching the upstream RulesEngine_TestEvaluateRuleRequest schema; see the Linnworks API reference for its field-level breakdown.
- **create_a_linnworks_rules_engine_set_draft_live** — Set a draft rule live in the Linnworks Rules Engine — if the draft is a copy for editing an existing rule, the existing rule is deleted and the draft promoted in its place. Takes a JSON request body (RulesEngine_SetDraftLiveRequest). Returns an int32 integer response body on success.
- **create_a_linnworks_rules_engine_create_draft_from_existing** — Create a draft copy of an existing Linnworks rule so it can be edited; once set live, the draft replaces the rule it was copied from. Returns an integer result on success. Required: a JSON request body identifying the existing rule to copy.
- **create_a_linnworks_rules_engine_create_new_draft_from_existing** — Create a new draft rule in linnworks based on an existing rule; once set live, the draft becomes a unique rule in its own right. Returns the created rule header record (the RuleHeaderBasic object). Required: a JSON request body (RulesEngine_CreateNewDraftFromExistingRequest).
- **create_a_linnworks_rules_engine_create_new_draft** — Create a new draft rule of a specified type in the Linnworks Rules Engine. Returns the created draft rule's basic header record, including its id and rule attributes. Requires a JSON request body specifying the rule type.
- **create_a_linnworks_rules_engine_set_rule_enabled** — Set the enabled state of a rule in the Linnworks rules engine. Returns an empty 204 response on success. Requires a JSON request body identifying the rule and the desired enabled state.
- **create_a_linnworks_rules_engine_set_rule_name** — Rename a rule in the Linnworks rules engine. Returns an empty 204 response on success. Requires a JSON request body identifying the rule and its new name.
- **delete_a_linnworks_rules_engine_delete_rule_by_id_by_id** — Permanently delete a rule from the Linnworks rules engine by id. Returns an empty 204 response on success. Requires a JSON request body conforming to the upstream RulesEngine_DeleteRuleByIdRequest schema (send the id of the rule to remove).
- **create_a_linnworks_rules_engine_swap_rule** — Swap the executing order of two rules in the linnworks Rules Engine by swapping them with each other. Returns an empty 204 response on success. Requires a JSON request body (RulesEngine_SwapRulesRequest) identifying the two rules to swap.
- **create_a_linnworks_rules_engine_set_condition_enabled** — Enable or disable a rules engine condition in linnworks; while disabled, the condition's subconditions and actions are not evaluated or executed. Requires a JSON request body identifying the condition and the enabled state to apply. Returns an empty 204 response on success.
- **create_a_linnworks_rules_engine_copy_condition** — Copy a condition in the linnworks Rules Engine as a new condition, cloning its subconditions and actions. Returns the copied condition's header (RuleConditionHeader), including its id and the remaining upstream-defined header fields (attributes). Requires a JSON request body specifying the condition to copy.
- **create_a_linnworks_rules_engine_copy_action** — Copy an action from one condition to another in the linnworks Rules Engine. Returns the copied rule action object; the upstream API docs do not enumerate its fields. Requires a JSON request body. Actions cannot be attached to the rule header or to conditions with subconditions.
- **list_all_linnworks_settings_get_currency_conversion_rates** — Get the currency conversion rates configured in linnworks Settings. Returns an array of CurrencyConversionRate records describing conversion rates between currencies, with optional filters to narrow by currency or include currencies from orders.
- **list_all_linnworks_settings_get_available_time_zones** — List the available time zones in linnworks. Returns the upstream GetAvailableTimeZonesResponse object; its field structure is not enumerated in the source documentation. Takes no parameters.
- **update_settings_update_currency_conversion_rate_by_id** — Update currency conversion rates in linnworks by posting the updated rates payload. Requires a JSON request body. Returns an empty 204 response on success.
- **create_a_linnworks_settings_insert_currency_conversion_rate** — Insert currency conversion rates in Linnworks. Returns an empty 204 response on success. Requires a JSON request body matching the Settings_InsertCurrencyConversionRatesRequest schema; consult the upstream docs for the field-level breakdown.
- **delete_settings_delete_currency_conversion_rate_by_id** — Delete currency conversion rates in Linnworks. Requires a JSON request body matching the upstream Settings_DeleteCurrencyConversionRatesRequest schema. Returns an empty 204 response on success.
- **list_all_linnworks_settings_get_measures** — Get the user's measures units from the database in Linnworks. Returns the Measures response object; its field structure is defined by the upstream Measures schema — consult the Linnworks API reference for the field-level breakdown.
- **list_all_linnworks_settings_get_latest_currency_rates** — Get the latest currency conversion rates for all known currencies in linnworks. Returns a mapping of currency codes to their latest conversion rates, keyed by currency code; the rates are updated every couple of hours.
- **list_all_linnworks_shipping_service_get_integrations** — List all configured vendor shipping integrations in linnworks. The response is a JSON array of integration configuration records; the upstream API docs do not publish a field-level breakdown of each record. Returns: items.
- **create_a_linnworks_shipping_service_post_shipment_upload** — Upload a shipment document to Linnworks via the Shipping Service. Returns an empty 204 response on success. Requires a JSON request body matching the upstream PostShipmentUploadRequest schema.
- **list_all_shipping_service_get_consignments_by_manifests** — List the consignments for a specific vendor, account, and manifest in Linnworks. Returns a paged result with PageNumber, EntriesPerPage, TotalEntries, TotalPages, and a Data array of consignment records. Required: vendor, accountId, pkManifestId. Use /ShippingService/GetFiledManifestsByVendor to source the input arguments.
- **list_all_shipping_service_get_filed_manifests_by_vendors** — List Linnworks filed shipping manifests for a vendor between two dates; use the GetIntegrations endpoint to get all vendor names and friendly names. Returns: PageNumber, EntriesPerPage, TotalEntries, TotalPages, and Data — the filed manifest records for the requested vendor and date range.
- **list_all_linnworks_shipping_service_get_shipping_quotes** — Get a shipping quote for a single Linnworks order by running it against integrated shipping services (the available services are listed via ShippingService/GetIntegrations). Returns the shipping quote response for the order; a selected service can then be applied to the order with ShippingService/SetShippingMethodFromQuote.
- **create_a_linnworks_shipping_service_cancel_order_shipping_label** — Cancels the shipping label for an order in Linnworks. Returns a cancellation response object whose structure is defined by the upstream CancelOrderShippingLabelResponse schema.
- **list_all_linnworks_ship_station_get_ship_station_integrations** — List all ShipStation integrations in linnworks. Returns the integration config records including their id and attributes with the upstream ShipStationConfig fields.
- **get_ship_station_get_ship_station_integration_by_id** — Get a single ShipStation integration in linnworks by id. Returns the integration config record including its id and attributes with the upstream ShipStationConfig fields.
- **create_a_linnworks_ship_station_create_ship_station_integration** — Create a new ShipStation integration in Linnworks. Returns the created ShipStationConfig, including its integrationId (the identifier to pass to GetShipStationIntegration later). Requires a JSON request body; the field set follows Linnworks' ShipStation_CreateShipStationIntegrationRequest schema.
- **delete_ship_station_delete_ship_station_integration_by_id** — Delete a ShipStation integration in Linnworks by its id. Returns an empty 204 response on success. Required: id.
- **create_a_linnworks_ship_station_edit_ship_station_integration** — Update an existing ShipStation integration in Linnworks. Returns a boolean success flag. Requires a JSON request body matching the Linnworks ShipStation_EditShipStationIntegrationRequest schema.
- **list_all_linnworks_stock_check_variation_parent_sku_exists** — Check whether a potential parent SKU already exists in Linnworks and report its current status. Returns one of: Exists, NotExists, AlreadyVariation. Required: parentSKU.
- **list_all_linnworks_stock_get_variation_group_search_types** — List the search types available for searching variation groups in Linnworks. Returns a JSON array of GenericEnumDescriptor entries — the search types consumed by the searchType parameter of SearchVariationGroups (VariationName, ParentSKU, ItemSKU); the Linnworks spec references the descriptor schema without enumerating its fields. Takes no parameters.
- **list_all_linnworks_stock_search_variation_groups** — Search Linnworks variation groups by variation name, parent SKU, or item SKU using a full or partial search term. Returns a paged result: Data, TotalEntries, TotalPages, PageNumber, EntriesPerPage.
- **list_all_linnworks_stock_delete_variation_groups** — Delete a single Linnworks variation group by its id. Returns an empty 204 response on success. Required: pkVariationGroupId (uuid).
- **delete_a_linnworks_stock_delete_variation_group_by_id** — Delete multiple Linnworks variation groups in bulk by their ids. Returns an empty 204 response on success. Requires a JSON request body matching the upstream Stock_DeleteVariationGroupsRequest schema.
- **list_all_linnworks_stock_get_variation_group_by_parent_ids** — Get the Linnworks variation group that a parent SKU belongs to by searching with the parent's stock item id. Returns the matching variation group with its pkVariationGroupId. Required: pkStockItemId.
- **list_all_linnworks_stock_get_variation_group_by_names** — Search Linnworks for a variation group by its group name. Returns the matched variation group record: id plus its vendor-defined group attributes. Required: variationName.
- **create_a_linnworks_stock_rename_variation_group** — Rename a variation group in Linnworks. Returns an empty 204 response on success. Requires a JSON request body matching the upstream Stock_RenameVariationGroupRequest schema; the available documentation does not expand its field list, so consult the Linnworks API reference for the exact payload.
- **list_all_linnworks_stock_get_variation_items** — Get the items in a Linnworks variation by its variation item id. Returns an array of variation item (VariationItem) records.
- **create_a_linnworks_stock_add_variation_item** — Add one or more items to an existing variation group in Linnworks. Returns the added variation items as an array of VariationItem records, each with pkVariationItemId plus the remaining VariationItem fields under attributes. Requires a JSON request body matching the upstream Stock_AddVariationItemsRequest schema, identifying the variation group and the items to add.
- **delete_a_linnworks_stock_delete_variation_item_by_id** — Delete a single Linnworks variation item, removing it from its variation group. Returns an empty 204 response on success. Requires a JSON request body identifying the item to remove (the upstream request schema's field names are not enumerated in the source).
- **linnworks_stock_delete_variation_items_bulk_delete** — Delete multiple Linnworks variation items in bulk, removing them from their variation group. Returns an empty 204 response on success. Requires a JSON request body identifying the items to remove (the upstream request schema's field names are not enumerated in the source).
- **create_a_linnworks_stock_create_variation_group** — Create a variation group in Linnworks. Returns the created variation group object as defined by the upstream VariationGroup schema; the available reference does not enumerate its fields. Requires the JSON request body defined by Stock_CreateVariationGroupRequest.
- **list_all_linnworks_stock_sku_exists** — Check whether a SKU already exists in Linnworks. Returns a boolean — true when the SKU exists, false otherwise. Required: SKU.
- **list_all_linnworks_stock_get_stock_consumptions** — Retrieve the linnworks stock consumption report between two dates. Returns report rows with id and attributes (fields defined by the upstream StockConsumption schema).
- **list_all_linnworks_stock_get_item_changes_histories** — Get a paged report of stock changes for an item in Linnworks. Returns: PageNumber, EntriesPerPage, TotalEntries, TotalPages, and a Data array of item change history entries. Set pageNumber to -1 to return all pages.
- **list_all_linnworks_stock_get_item_changes_history_csvs** — Get a link to a CSV file report of a Linnworks stock item's stock changes. Returns an opaque TempFile payload for the generated report; its fields are not enumerated in the upstream documentation.
- **list_all_linnworks_stock_get_stock_items** — List Linnworks stock items matching a keyword, optionally scoped to a location, with flags to exclude composites, variations, or batches from the report. Returns a paged result with TotalResults and the matching stock item records in Data.
- **get_single_linnworks_stock_get_stock_items_by_key_by_id** — Get Linnworks stock items for the provided key and location. Returns an array of stock item objects (the upstream StockItem record shape). Requires a JSON request body identifying the key and location to look up.
- **get_single_linnworks_stock_get_stock_items_full_by_id** — Get basic-level inventory information for stock items in Linnworks. Returns a JSON array of stock item records (upstream StockItemFull schema), each identified by id. Requires a JSON request body (upstream Stock_GetStockItemsFullRequest schema).
- **get_single_linnworks_stock_get_stock_items_full_by_id_by_id** — Get basic-level inventory item information in linnworks for one or more stock items by supplying their ids in the request body. Returns the matching inventory item records including each item's id and basic-level item attributes. Requires a request body (upstream schema Stock_GetStockItemsFullByIdsRequest) carrying the stock item ids.
- **list_all_linnworks_stock_get_stock_levels** — Get the item stock level report from Linnworks. Returns an array of stock item levels with ItemId, SKU, Level, MinimumLevel, InOrderBook, and AvailableStock. Optional: stockItemId (uuid) to specify a stock item.
- **get_single_linnworks_stock_get_stock_level_by_location_by_id** — Retrieve the item stock level report grouped by location in Linnworks. Returns the JSON report body defined by Linnworks' GetStockLevelByLocationResponse contract (its fields are not enumerated in the available source). Requires a JSON request body following the upstream Stock_GetStockLevelByLocationRequest schema.
- **get_single_linnworks_stock_get_stock_level_batch_by_id** — Get a batch "item stock level" report from Linnworks by POSTing a JSON request body that follows the upstream Stock_GetStockLevel_BatchRequest schema. Returns a JSON array of GetStockLevel_BatchResponse report entries; the source documentation references these schemas but does not enumerate their fields.
- **update_a_linnworks_stock_update_stock_minimum_level_by_id** — Update a stock item's minimum stock level in Linnworks. Returns an empty 204 response on success. Requires a JSON request body matching Linnworks' Stock_UpdateStockMinimumLevelRequest schema; the API reference does not enumerate its fields.
- **list_all_linnworks_stock_get_stock_solds** — Get the Linnworks "item stock sold" report. Returns an array of stock-sold report rows with schema-specific StockItemSold fields.
- **list_all_linnworks_stock_get_stock_due_pos** — List Linnworks stock due PO report entries. Returns an array of StockItemDuePO report records, each with a primary id and an attributes object whose fields are report-specific as defined upstream.
- **list_all_linnworks_stock_get_stock_item_return_stats** — Get the item return stat report for a stock item in linnworks. Returns a JSON array of item return stat entries (StockItemReturn), each including id plus content-type-specific report fields.
- **list_all_linnworks_stock_get_stock_item_scrap_stats** — Retrieve the Linnworks "item stock scrap stat" report for a stock item. Returns a 200 OK JSON array of StockItemScrap scrap-stat report entries; the upstream documentation does not enumerate the entry fields.
- **list_all_linnworks_stock_get_sold_stats** — Get Linnworks' item sold stat report. Returns an array of sold-stat records, each carrying an id and attributes holding the upstream StockItemSoldStat fields.
- **create_a_linnworks_stock_set_stock_level** — Set the stock level of a list of stock items in Linnworks, identified by SKU, to the provided values. Returns an array of stock item level records for the updated items. Requires a JSON body matching the SetStockLevel request schema.
- **update_a_linnworks_stock_update_stock_levels_by_skus_by_id** — Update the stock levels of a list of Linnworks stock items identified by SKU, changing each level by the provided value. Returns an array of stock item level objects, one per updated item. Requires a JSON request body.
- **create_a_linnworks_stock_book_in_stock_item** — Book in a stock item in Linnworks: increases its stock level and current stock value by the specified quantity. Requires a JSON request body (Stock_BookInStockItemRequest). Returns an empty 204 response on success.
- **create_a_linnworks_stock_create_stock_batch** — Create one or more stock item batches in Linnworks. Returns the created batches as an array, each including BatchId, SKU, BatchNumber, ExpiresOn, SellBy, and per-location Inventory records. Requires a JSON request body following the upstream Stock_CreateStockBatchesRequest schema.
- **create_a_linnworks_stock_book_in_stock_batch** — Book in stock for a batched stock item in Linnworks, increasing its stock level and current stock value by the specified quantity. Returns the updated StockItemBatch including BatchId, SKU, BatchNumber, StockItemId, ExpiresOn, SellBy, and its per-location Inventory records. Requires a JSON request body.
- **linnworks_stock_search_binracks_search** — Search binracks in Linnworks where a stock item can be placed, ordered by the system's recommended move order. Returns matched binracks with id and binrack-specific attributes. Requires a JSON request body; if no binrack type ids are supplied, all binrack types are considered.
- **get_single_linnworks_stock_get_bin_racks_by_id_by_id** — Get the list of binracks by binrack ids for Linnworks WMS locations. Returns the matching binrack records with their id.
- **get_single_linnworks_stock_get_binrack_skus_by_id** — Get binrack SKU records in Linnworks. Returns the upstream BinrackSkuResponse object (200 OK); its field-level structure is not enumerated in the Linnworks documentation. Send the upstream GetBinRackSkusRequest JSON object as the request body.
- **delete_a_linnworks_stock_delete_move_by_id** — Delete a stock move in Linnworks. Requires a JSON request body. Returns an empty 204 response on success.
- **get_single_linnworks_stock_get_warehouse_moves_by_binrack_by_id** — Get details for stock moves within a specific binrack in Linnworks, returning both incoming and outgoing stock. Returns the warehouse-move details for that binrack, with fields defined by the upstream GetWarehouseMovesByBinrackResponse schema. Requires a JSON request body identifying the binrack.
- **get_single_linnworks_stock_get_warehouse_move_by_id** — Get details for a single warehouse stock move in Linnworks. Returns the stock move object: id plus its move-detail fields (modeled here as attributes), which are defined by the upstream GetWarehouseMoveResponse schema. The request body identifies the stock move to fetch.
- **create_a_linnworks_stock_complete_warehouse_move** — Complete a warehouse stock move in Linnworks. Requires a JSON request body (upstream Stock_CompleteWarehouseMoveRequest schema; the source does not enumerate its individual fields). Returns an empty 204 response on success.
- **update_a_linnworks_stock_update_warehouse_move_by_id** — Update an existing warehouse stock move in Linnworks. Returns the updated stock move object (upstream GetWarehouseMoveResponse schema). Requires a JSON request body matching the upstream UpdateWarehouseMoveRequest schema.
- **create_a_linnworks_stock_create_warehouse_move** — Create a warehouse move in Linnworks in state of In Transit or Open. Returns the created move's id. Required: BatchInventoryId. BinrackIdDestination is optional — omit it or send null to create the move without a specific destination bin.
- **create_a_linnworks_stock_batch_stock_level_delta** — Apply a batch of stock level delta updates to stock items in Linnworks in a single request. Returns a batch stock level delta result object. Requires a batch stock level delta request body.
- **create_a_linnworks_stock_add_rolling_stock_take** — Add a rolling stock take (count) entry in Linnworks. Each request creates a session for the UTC-day stock count, adds all entries, and recounts totals and discrepancies; it is rejected if any entry fails validation. Returns an opaque AddRollingStockTakeResponse acknowledgement — the upstream schema does not enumerate its fields. Required: BatchInventoryId for WMS locations or batched items.
- **update_a_linnworks_stock_update_stock_levels_bulk_by_id** — Bulk update stock levels for non-batched and composite stock items in build in Linnworks. Returns the UpdateStockLevelsBulkResponse result; its individual fields are not enumerated in the docs (surfaced here as attributes). Accepts StockItemId or SKU (either identifier) plus a stock location name or id.
- **get_single_linnworks_stock_get_stock_items_by_id_by_id** — Retrieve stock item records from Linnworks for a specified list of stock item ids. Requires a request body containing the stock item ids to retrieve. Returns the matching stock item records; Linnworks defines the response via a named schema (GetStockItemsByIdsResponse) whose fields are not enumerated in the published reference for this endpoint, so treat the response shape as opaque.
- **get_single_linnworks_stock_get_stock_item_type_info_by_id** — Get stock item type information for linnworks stock items. Accepts a JSON request body and returns the upstream-defined type info response on success; the field-level shape of that response is not enumerated in the available source, so confirm fields against the Linnworks API reference (GetStockItemTypeInfoResponse).
- **update_a_linnworks_stock_update_sku_group_identifier_by_id** — Update a SKU group identifier in linnworks. Returns the UpdateSkuGroupIdentifier response object as defined by the Linnworks API; its fields are not enumerated in the API docs.
- **get_single_linnworks_stock_get_stock_items_location_by_id** — Get the warehouse location (including binrack) for a given list of stock items in Linnworks. Returns the location details for each requested item and location combination: StockItemId, StockLocationId, and BinRack. Requires stockItemIds and stockLocationIds in the request body.
- **list_all_warehouse_transfer_get_active_transfers_for_locations** — List all active warehouse transfers related to a location in Linnworks. Returns an array of transfer records, each with an id and transfer-specific attributes. Accepts locationId (the pkLocationId of the location to look up).
- **list_all_warehouse_transfer_get_active_transfers_all_locations** — List all active warehouse transfers across all locations in Linnworks. Returns a collection of transfer records, each with an id and the transfer fields defined by Linnworks's upstream WarehouseTransfer schema (attributes). Takes no parameters.
- **create_warehouse_transfer_create_transfer_request_with_return** — Create a new warehouse transfer request in Linnworks with a default reference number. Returns the created warehouse transfer object. Requires a request body.
- **create_warehouse_transfer_create_transfer_from_descrepancy** — Create a new warehouse transfer request in linnworks from detected stock discrepancies. Returns the created WarehouseTransfer object (field set defined by the upstream schema) on success. Send the transfer details as a JSON request body matching the upstream WarehouseTransfer_CreateTransferFromDescrepanciesRequest schema.
- **delete_a_linnworks_warehouse_transfer_delete_transfer_by_id** — Delete a warehouse transfer in linnworks. Returns an empty 204 response on success. Requires a JSON request body identifying the transfer to remove.
- **delete_warehouse_transfer_delete_transfer_property_by_id** — Delete a property from a warehouse transfer in linnworks. Returns an empty 204 response on success. Requires a JSON body identifying the transfer and the property to delete.
- **list_all_linnworks_warehouse_transfer_get_transfer_with_notes** — Get a single Linnworks warehouse transfer together with its items and notes. Returns the transfer record as id plus an attributes object holding the transfer's details. Required: pkTransferId (UUID).
- **create_a_linnworks_warehouse_transfer_change_transfer_status** — Change a warehouse transfer's status in Linnworks, moving it along its transfer workflow. Returns an empty 204 response on success. Requires a JSON request body identifying the transfer and the new status to set.
- **create_a_linnworks_warehouse_transfer_add_transfer_note** — Add a note to a warehouse transfer in linnworks. Returns a UUID string identifying the added transfer note. Requires a JSON request body (fields defined by the upstream WarehouseTransfer_AddTransferNoteRequest schema).
- **create_a_linnworks_warehouse_transfer_add_transfer_bin_note** — Add a note to a warehouse transfer bin in linnworks. Returns the id of the created bin note as a UUID string. Requires a JSON request body matching the upstream WarehouseTransfer_AddTransferBinNoteRequest schema.
- **create_a_linnworks_warehouse_transfer_add_item_to_transfer** — Add a single item to a warehouse transfer in linnworks by posting the WarehouseTransfer_AddItemToTransferRequest JSON payload; only transfers in draft or request states accept items. Returns the added transfer item object (upstream WarehouseTransferItem schema; the source docs reference it without enumerating its fields).
- **create_a_linnworks_warehouse_transfer_add_items_to_transfer** — Add one or more items to a Linnworks warehouse transfer; only works for transfers in draft or request states. Requires the AddItemsToTransferRequest body identifying the transfer and the items to add. Returns the AddItemsToTransfer response object with vendor-defined fields not enumerated in the API reference.
- **create_a_linnworks_warehouse_transfer_add_transfer_property** — Add a property to a warehouse transfer in linnworks. Returns the result as a UUID string on success. Requires a JSON request body with the transfer property details.
- **create_a_linnworks_warehouse_transfer_remove_item_from_transfer** — Remove an item from a warehouse transfer in linnworks. Requires a JSON request body (upstream schema WarehouseTransfer_RemoveItemFromTransferRequest; its field names are not enumerated in the reference). Returns an empty 204 response on success.
- **create_a_linnworks_warehouse_transfer_set_reference_number** — Change a warehouse transfer's reference number in Linnworks; only works before the transfer is in transit. Returns an empty 204 response on success. Required: a JSON request body matching the upstream WarehouseTransfer_SetReferenceNumberRequest schema.
- **create_warehouse_transfer_change_transfer_from_location** — Update the from location of a warehouse transfer in linnworks. Returns an empty 204 response on success. Requires a request body identifying the transfer and the location the stock should now come from.
- **create_warehouse_transfer_change_transfer_to_location** — Change the to (destination) location of a warehouse transfer in Linnworks. Returns an empty 204 response on success. Requires a JSON request body identifying the transfer and the new destination location.
- **create_a_linnworks_warehouse_transfer_change_transfer_location** — Update the from and to locations of a warehouse transfer in linnworks. Requires a JSON request body matching the upstream ChangeTransferLocations request schema. Returns an empty 204 response on success.
- **create_a_linnworks_warehouse_transfer_change_transfer_property** — Change a property belonging to a given warehouse transfer in Linnworks by posting the property change details as a required JSON request body. Returns an empty 204 response on success.
- **list_all_linnworks_warehouse_transfer_get_transfer_items** — List the items of a Linnworks warehouse transfer identified by pkTransferId. Returns an array of WarehouseTransferItem records, one entry per bin an item occupies, covering the item's order, request, sent, and received quantities. Each record's fields follow the upstream WarehouseTransferItem schema, which the available documentation does not enumerate.
- **create_warehouse_transfer_change_transfer_item_request_quantity** — Change the requested quantity for an item on a linnworks warehouse transfer; only transfers in Draft or Request states are supported. Returns an empty 204 response on success. Requires a JSON request body.
- **create_warehouse_transfer_change_transfer_item_sent_quantity** — Change the sent quantity of a warehouse transfer item in the specified bin in linnworks. Returns the updated transfer item: id plus its attributes object, which carries the upstream WarehouseTransferItem fields (item identifiers and request/sent/received quantity levels per bin). Requires a request body identifying the transfer item, bin, and the new sent quantity.
- **create_warehouse_transfer_change_transfer_item_received_quantity** — Change the received quantity of a transfer item in Linnworks. Returns an empty 204 response on success. Requires a JSON request body matching the upstream WarehouseTransfer_ChangeTransferItemReceivedQuantityRequest schema.
- **list_all_linnworks_warehouse_transfer_get_transfer_notes** — List transfer-level notes for a warehouse transfer in linnworks. Returns an array of note records, each with its id plus an attributes object holding the note fields defined by the upstream WarehouseTransferNote schema. Required: pkTransferId.
- **list_all_linnworks_warehouse_transfer_get_transfer_item_notes** — Get the notes attached to a transfer item in linnworks. Returns an array of transfer item note objects. Required: pkTransferId, pkTransferItemId.
- **create_a_linnworks_warehouse_transfer_add_transfer_item_note** — Add a note to a transfer item in linnworks. Returns a UUID string on success. Requires a JSON request body describing the note.
- **list_all_linnworks_warehouse_transfer_get_transfer_audits** — Retrieve all audit entries for a specified warehouse transfer in linnworks. Returns an array of audit entry records, each with an id and attributes whose fields are specific to the upstream WarehouseTransferAudit schema and not enumerated in the API docs. Required: pkTransferId (the transfer's UUID).
- **list_all_linnworks_warehouse_transfer_get_transfer_properties** — Get the properties associated with a given warehouse transfer in Linnworks, identified by its pkTransferId. Returns the list of transfer property records, each with its id and property attributes.
- **list_all_warehouse_transfer_search_transfers_all_locations** — Search linnworks warehouse transfers across all locations matching a specific criteria such as SKU, item title, item barcode, transfer reference, or bin reference. Returns an array of matching transfer ids as UUID strings.
- **list_all_linnworks_warehouse_transfer_get_archived_transfers** — List all archived warehouse transfers in Linnworks — transfers that are Delivered or Deleted. Returns: PageNumber, EntriesPerPage, TotalEntries, TotalPages, and a Data array of archived transfer records.
- **list_all_warehouse_transfer_get_archived_transfers_filtereds** — Search archived warehouse transfers in Linnworks that match a specific search term. Returns a paged result: PageNumber, EntriesPerPage, TotalEntries, TotalPages, and Data (the matched transfers).
- **list_all_warehouse_transfer_get_archived_transfers_between_dates** — Search Linnworks for archived warehouse transfers which were created between two dates. Returns a paged result including TotalEntries, TotalPages, PageNumber, EntriesPerPage, and a Data array of archived transfer records.
- **warehouse_transfer_get_archived_transfers_between_archived_dates** — Search for Linnworks warehouse transfers that were archived between two dates. Returns a paged result: PageNumber, EntriesPerPage, TotalPages, TotalEntries, and a Data array of archived transfer records.
- **list_all_warehouse_transfer_search_transfers_by_locations** — Search linnworks warehouse transfers matching specific criteria by SKU, item title, item barcode, transfer reference, or bin reference within a location. Returns an array of matching transfer id UUID strings.
- **get_single_linnworks_warehouse_transfer_get_list_transfer_by_id** — List basic warehouse transfers in linnworks. Returns an array of transfer records, each with its id. Requires a JSON request body (the upstream GetListTransfers request object).
- **list_all_linnworks_warehouse_transfer_get_modified_basics** — List Linnworks warehouse transfers that were significantly modified between a specified UTC date/time and now. Returns basic transfer records, each with an id and its transfer attributes.
- **list_all_linnworks_warehouse_transfer_get_server_times** — Get the current UTC server time from linnworks. Returns the current UTC date as a single date-time string value. Takes no parameters.
- **list_all_linnworks_warehouse_transfer_get_transfer_with_items** — Get a warehouse transfer with its items in linnworks by transfer id. Returns the transfer object with its items; the field set is defined by the upstream WarehouseTransfer schema and is not enumerated in the source docs. Required: pkTransferId.
- **create_a_linnworks_warehouse_transfer_change_bin_detail** — Update the details of an existing bin via Linnworks' warehouse transfer API. Requires a JSON request body following the upstream WarehouseTransfer_ChangeBinDetailsRequest schema. Returns an empty 204 response on success.
- **create_a_linnworks_warehouse_transfer_allocate_item_to_bin** — Allocate stock, in part or in full, from one bin to another in Linnworks. Returns an integer (int32) result value on success. Requires a JSON request body matching the upstream AllocateItemToBinRequest schema.
- **create_a_linnworks_warehouse_transfer_create_new_bin** — Create a new bin in Linnworks for warehouse transfer use. Returns the created bin object (WarehouseTransferBin) with the new bin's details. Requires a JSON request body (CreateNewBinRequest).
- **create_a_linnworks_warehouse_transfer_remove_all_empty_bin** — Remove all empty bins in Linnworks — deletes bins that have no items assigned (e.g. bins created but never used). Requires a JSON request body. Returns an empty 204 response on success.
- **list_all_linnworks_warehouse_transfer_get_transfer_bin_notes** — Get the notes recorded against a specific warehouse transfer bin in linnworks, identified by the pkBinId query parameter. Returns a JSON array of bin note (WarehouseTransferBinNote) objects; the linnworks API reference does not enumerate the note fields.
- **list_all_linnworks_warehouse_transfer_get_discrepancy_items** — Get Linnworks warehouse transfer items whose quantities do not match what was originally expected (e.g. fewer received than sent when the transfer is delivered, or fewer sent than requested when accepted). Returns an array of transfer item records identified by id with upstream-defined attributes. Call once after the transfer is Accepted and once when it has been Delivered. Required: pkTransferId.
- **list_all_linnworks_warehouse_transfer_get_stock_availabilities** — Get stock availability for a transfer item in Linnworks, listing the inbound warehouse transfers and purchase orders due in for that item. Returns an array of StockAvailability records; the field-level shape is not enumerated in the available documentation. Lookup key: pkTransferItemId (UUID).
- **list_all_linnworks_warehouse_transfer_is_draft_transfer_changeds** — Check whether a draft warehouse transfer in linnworks has been changed since it was created. Returns a boolean — true when the draft transfer has changed, false otherwise. Required: pkTransferId.
- **delete_warehouse_transfer_delete_empty_draft_transfer_by_id** — Delete an empty draft warehouse transfer in linnworks — only draft transfers with no items, properties or notes can be removed this way. Returns an empty 204 response on success. Requires a JSON request body identifying the draft transfer.
- **list_all_linnworks_warehouse_transfer_check_for_draft_transfers** — Check whether a draft warehouse transfer already exists between two locations in linnworks. Returns the UUID of the matching draft transfer, if one exists. Supply toLocationId (destination location) and fromLocationId (source location).
- **create_a_linnworks_warehouse_transfer_print_transfer** — Create a printable PDF for a Linnworks warehouse transfer. Returns the URL of the generated PDF as a string. Required: a JSON request body matching the upstream WarehouseTransfer_PrintTransferRequest schema.
- **list_all_linnworks_fbatransfercards_metadata** — Get metadata for the Linnworks FBA inbound transfer cards view. Returns the view metadata object; its field-level shape is defined by the upstream GetViewMetaDataResponse schema and is not itemized in the v1 documentation. No required parameters. Deprecated — use the v2 metadata endpoint instead.
- **create_a_linnworks_import_upload** — Upload a CSV file to Linnworks for warehouse transfer import processing, selecting the kind of import via import_type. Required: import_type. Returns the upload result payload; its field structure is not enumerated in the Linnworks API documentation.
- **create_a_linnworks_import_importstockrequestitem** — Import product items into a Linnworks warehouse-transfer stock request. Returns the import result response for the completed import. Required: importstockrequestitem_id (the stock request import id) and a JSON request body.
- **create_a_linnworks_import_importstocktransferitem** — Import items into a Linnworks stock transfer via CSV import (ImportCsv). Returns the import result object on success. Required: importstocktransferitem_id (the id of the stock transfer to import items into, passed upstream as the transferId path parameter).
- **list_all_linnworks_warehousetransfer_stocks** — Find Linnworks stock items by channel for warehouse transfers (FindStockItem). Returns a paged result containing Data (the matching stock items) plus PageNumber, EntriesPerPage, TotalEntries, and TotalPages. entriesPerPage is capped at 200 per page.
- **list_all_linnworks_stock_find_warehouse_transfer_stock_items** — Find Linnworks stock items available for a warehouse transfer, optionally filtered by keyword and by source/destination location. Returns a paged result with PageNumber, EntriesPerPage, TotalEntries, TotalPages, and a Data array of stock items. Max 200 entries per page.
- **linnworks_transfers_add_items_bulk_update** — Add an item to a Linnworks stock transfer. Only works for transfers in draft or request states. Requires an AddItemRequest JSON body. Returns a TransferItemViewModel transfer-item object; the upstream docs name this response schema but do not enumerate its fields.
- **create_a_linnworks_transfers_add_item_batch** — Add item batches to a Linnworks warehouse transfer, providing batch-level detail such as batch number, quantity, stock item, and expiry/sell-by dates in a JSON body matching the AddItemBatchesRequest schema. Returns a boolean success flag. Required: a JSON body matching the AddItemBatchesRequest schema. Read back assigned batches with the transfers_get_transfer_item_batches method.
- **create_a_linnworks_transfers_add_items_in_bulk** — Add multiple items in bulk to a linnworks stock transfer. Returns a boolean result (true on success). Call with an AddItemsInBulkRequest JSON body; the upstream docs do not enumerate its fields.
- **linnworks_transfers_check_for_draft_transfers_bulk_update** — Check whether a draft stock transfer already exists between two locations in linnworks. Returns a single integer (int32) value on success. Requires a JSON request body of type CheckForDraftTransferRequest identifying the two locations to check.
- **create_a_linnworks_transfers_create_transfer** — Create a new warehouse transfer request in Linnworks with a system-generated default reference number by posting a CreateTransferRequest JSON body. Returns the created transfer object (WarehouseTransferViewModel) including its id and transfer-specific attributes.
- **linnworks_transfers_delete_items_bulk_delete** — Remove items from a stock transfer in linnworks. Returns a bare integer result on success rather than the transfer object. Requires a JSON request body (upstream schema: DeleteItemsRequest) identifying the transfer and the items to remove; the source documentation does not enumerate its fields, so consult the linnworks API reference for the exact payload shape.
- **linnworks_transfers_delete_warehouse_transfers_bulk_delete** — Delete a stock transfer in Linnworks. Returns a bare integer success value (the 200 response body is a plain int32, not an object). Required: a JSON request body of type DeleteTransferRequest identifying the transfer to delete.
- **linnworks_transfers_archive_warehouse_transfers_bulk_update** — Archive a warehouse transfer in Linnworks. Sends an ArchiveTransferRequest JSON payload and returns an integer (int32) result on success.
- **list_all_linnworks_transfers_get_list_transfers** — List the item lines of Linnworks warehouse transfers at the order and request/sent/received levels. Returns the transfer's item entries, with multiple entries for a single item when it exists in more than one bin.
- **list_all_linnworks_transfers_get_transfer_cards** — List all Linnworks warehouse transfers with their stock item details, available for searching. Returns the warehouse transfer card objects together with the stock items they contain. No required parameters.
- **list_all_linnworks_transfers_get_transfer_cards_by_locations** — Get warehouse transfer cards for a specific location in linnworks. Returns the transfer card view model including its id and attributes; attribute fields follow the upstream WarehouseTransferViewModel schema, so consult the Linnworks API docs for the field-level breakdown.
- **get_single_linnworks_transfers_get_transfer_item_batch_by_id** — Get the item batches for a Linnworks warehouse transfer by id. Returns the batch lookup response object including its id and the upstream-defined batch attributes. Required: id (the numeric transfer id).
- **linnworks_transfers_get_transfer_items_bulk_update** — Get the stock items on a Linnworks warehouse transfer for the appropriate location, including item details for searching. Returns a transfer item record with its id and an attributes object whose fields are defined upstream in the TransferItemViewModel schema. Required: pkTransferId.
- **linnworks_transfers_update_from_locations_bulk_update** — Update the from location of a Linnworks warehouse transfer. Returns an integer result on success. Requires an UpdateFromLocationRequest JSON body; Linnworks references this schema without documenting its individual fields.
- **linnworks_transfers_update_item_received_quantities_bulk_update** — Update the received quantity of a stock transfer item in Linnworks, adjusting stock levels. Returns an integer (int32) value on success. Requires a JSON request body matching the upstream UpdateItemReceivedQuantityRequest schema.
- **linnworks_transfers_update_items_received_quantities_bulk_update** — Update the received quantities of multiple items on a Linnworks stock transfer, adjusting stock levels; batched items are received into the same batches they were originally sent with. Requires a JSON body containing the transfer id and the items with their new received quantities. Returns the update-quantities response object; the source does not enumerate its fields.
- **linnworks_transfers_update_item_requested_quantities_bulk_update** — Update the requested quantity of a stock transfer item in Linnworks, adjusting stock levels. Returns the updated quantity as an integer. Requires a JSON request body matching the UpdateItemRequestedQuantityRequest schema.
- **linnworks_transfers_update_item_sent_quantities_bulk_update** — Update the sent quantity of a stock transfer item in Linnworks, adjusting stock levels. Returns a boolean success result on a 200 response. Requires a JSON request body matching Linnworks' UpdateItemSentQuantityRequest schema.
- **linnworks_transfers_update_status_bulk_update** — Update the status of a Linnworks warehouse transfer. Returns the new status as a bare integer (HTTP 200). Required: a JSON request body matching the upstream UpdateStatusRequest schema.
- **linnworks_transfers_update_to_locations_bulk_update** — Update the to-location of a stock transfer in Linnworks. Returns a bare integer (int32) success value. Requires a JSON request body matching the upstream UpdateToLocationRequest schema; its individual fields are not enumerated in the source documentation.
- **create_a_linnworks_transfers_add_item_received_batch** — Add item received batches to a linnworks warehouse transfer, recording the batches received against the transfer's items. Returns a boolean success flag. Required: a JSON request body describing the received batches.
- **create_transfers_receive_selected_transfer_items_for_wm** — Receive selected stock transfer items in Linnworks, setting each item's receive quantity to its sent quantity for a WMS location. Returns a 200 Success response as either an integer result or a ReceiveSelectedTransferItemsForWmsResponse object (the object's fields are not detailed in the available docs). Sends a ReceiveSelectedTransferItemsForWmsRequest JSON body.
- **list_all_linnworks_wms_get_warehouse_zone_types** — List the warehouse zone types configured in linnworks. Returns the zone-type record including its id and the upstream-defined attributes. No required parameters.
- **update_a_linnworks_wms_update_warehouse_zone_type_by_id** — Update a warehouse zone type in Linnworks. Sends a JSON body matching the upstream UpdateWarehouseZoneTypeRequest schema and returns the updated zone type record as id plus an attributes object (the Linnworks reference does not enumerate the response fields).
- **create_a_linnworks_wms_add_warehouse_zone_type** — Create a warehouse zone type in linnworks WMS. Returns the AddWarehouseZoneTypeResponse object on a 200 OK response; the available docs reference its upstream schema but do not enumerate its fields. Requires a JSON request body following the upstream AddWarehouseZoneTypeRequest schema.
- **delete_a_linnworks_wms_delete_warehouse_zone_type_by_id** — Delete a warehouse zone type in linnworks. Returns a success confirmation on completion. Requires a JSON request body identifying the zone type to remove.
- **list_all_linnworks_wms_get_warehouse_zones_by_locations** — Get warehouse zones for a stock location in Linnworks, optionally limited to bin/rack-assignable zones. Returns a response object whose fields are defined by the upstream GetWarehouseZonesByLocationResponse schema (the discovered docs do not enumerate them). Both stockLocationIntId and onlyBinrackAssignable are optional.
- **get_wms_get_binrack_zones_by_binrack_id_or_name_by_id** — Get the Linnworks warehouse zones assigned to binracks, looking the binracks up by id or name. Returns a 200 zone-assignment response whose shape is defined by the upstream GetBinrackZonesByBinrackIdOrNameResponse schema; the Linnworks docs do not enumerate its fields. Requires a request body identifying the binrack(s).
- **update_wms_update_warehouse_binrack_binrack_to_zone_by_id** — Update the zone assignment for a warehouse binrack in Linnworks, moving the binrack into a zone. Takes a JSON request body defined by the upstream UpdateWarehouseBinrackBinrackToZone request schema and returns the corresponding response object; its fields are not enumerated in the available documentation.
- **get_wms_get_binrack_zones_by_zone_id_or_name_by_id** — Get Linnworks WMS binrack zones matching a zone id or name. The 200 response follows Linnworks' GetBinrackZonesByZoneIdOrNameResponse schema, whose field-level structure is not enumerated in the available documentation. Sends a JSON request body per the GetBinrackZonesByZoneIdOrNameRequest schema; no required parameters are documented.
- **create_a_linnworks_wms_add_warehouse_zone** — Add a new warehouse zone in Linnworks WMS. Returns the response object defined by the upstream AddWarehouseZoneResponse schema; consult the upstream Linnworks docs for the field-level breakdown. Requires a JSON request body matching the upstream AddWarehouseZoneRequest schema.
- **delete_a_linnworks_wms_delete_warehouse_zone_by_id** — Delete a warehouse zone in linnworks via the Wms API. RPC-style POST — the zone identifier goes in the JSON request body, not the path. Returns the upstream DeleteWarehouseZoneResponse JSON object; its fields are not enumerated in the available source.
- **update_a_linnworks_wms_update_warehouse_zone_by_id** — Update a warehouse zone in linnworks by posting an UpdateWarehouseZoneRequest JSON body. Returns the UpdateWarehouseZoneResponse object describing the updated zone. Required: a JSON body matching the UpdateWarehouseZoneRequest schema.
- **list_all_linnworks_orders** — List orders in Linnworks, returning open orders by default with optional filters for processed and paid orders, location, and a last-updated date range. Returns per-order fields including id, NumOrderId, GeneralInfo, ShippingInfo, CustomerInfo, and TotalsInfo. If id is supplied, all other parameters are disregarded.
- **list_all_linnworks_orders_fulfillment_status** — Get fulfillment statuses for one or more Linnworks orders by id. Returns each order's id and fulfillmentStatus. Filters: id (order ids), locationId, fulfillmentStatus.
- **update_a_linnworks_orders_fulfillment_status_by_id** — Update fulfillment statuses for multiple Linnworks orders in a single call. Returns each updated order's id and fulfillmentStatus. Required: id and fulfillmentStatus in each body array item.
- **get_single_linnworks_order_fulfillment_status_by_id** — Get the fulfillment status for a single Linnworks order by id. Returns the order's fulfillment status record including id and fulfillmentStatus. Required: id (the Linnworks order UUID).
- **linnworks_order_fulfillment_status_bulk_update** — Update the fulfillment status of a Linnworks order by id. Returns the updated order fulfillment status object. Required: order_id (UUID) plus a fulfillment status request body.
- **create_a_linnworks_orderpickwave_identifier** — Assign the provided identifiers to all provided pickwaves in Linnworks. Returns an empty response body on success. Pass the assign request (request) carrying the pickwaves and identifiers to assign.
- **list_all_linnworks_picking_pickwaveidentifiers** — List all pickwave identifiers in Linnworks. Returns each identifier with its IdentifierId, Name, Tag, IsCustom flag, and ImageId/ImageUrl image details.
- **create_a_linnworks_picking_pickwaveidentifier** — Create pickwave identifiers in Linnworks. Returns the created pickwave identifier object including its id, name, tag, and imageUrl. Requires a JSON body matching the upstream CreatePickwaveIdentifierRequest schema.
- **delete_a_linnworks_picking_pickwaveidentifier_by_id** — Delete a pickwave identifier from Linnworks by id. Returns an empty 204 response on success. Required: id (the upstream identifierId, a numeric int32).
- **get_single_linnworks_fba_inbound_channel_by_id** — Get details for a single FBA inbound channel in Linnworks by id. Returns the channel detail record; upstream does not enumerate its fields beyond the identifier id (the integer channelId in the path). Required: id.
- **list_all_linnworks_shipment_content_update_previews** — List generated content update previews for a shipment in linnworks FBA inbound. Returns preview objects identified by their string id (pass it as content_update_preview_id when confirming a preview). Required: shipping_plan_id, shipment_id.
- **create_a_linnworks_content_update_preview_confirm** — Confirm the content update preview for a shipment in a linnworks FBA inbound shipping plan. Returns the operation record including its id and type. Required: shipping_plan_id, shipment_id, content_update_preview_id.
- **create_a_linnworks_content_update_previews_generate** — Generate content update previews for a given shipment within a shipping plan in Linnworks FBA inbound. Returns the operation record object (OperationModel) tracking the preview generation; the published docs define its shape upstream and do not enumerate its fields. The request body must match Linnworks' ContentUpdatePreviewRequestModel. Required: shipping_plan_id, shipment_id, boxes, items.
- **list_all_linnworks_fba_inbound_metadata** — Get metadata for Linnworks FBA inbound transfer cards. Returns the view metadata object with upstream-specific fields (GetViewMetaDataResponse); the docs do not enumerate its structure. Takes no parameters.
- **get_single_linnworks_fba_inbound_operation_by_id** — Get a single Linnworks FBA inbound operation by its id (UUID). Returns the operation record including its id and operationType. Required: id.
- **list_all_linnworks_fba_inbound_operations** — List Linnworks FBA inbound operations, optionally filtered by entityId and operationType. Returns the operation record including its id and operationType.
- **list_all_linnworks_operations_latests** — GetOperationLatestByEntityIdTypes. Returns: id, entityId, status, type, createdDate, problems, amazonOperationId. Required: entity_id, operation_types.
- **list_all_linnworks_shipping_plan_packing_groups** — List the packing groups for an FBA inbound shipping plan in Linnworks. Returns each packing group record with its id and packing group attributes. Required: shipping_plan_id.
- **list_all_linnworks_shipping_plan_packing_options** — Get the generated packing options for a Linnworks FBA inbound shipping plan. Returns an array of packing option records, each with its id and option-specific attributes (fields are defined by Linnworks' PackingOptionModel; consult the upstream docs for the full field breakdown). Required: shipping_plan_id.
- **create_a_linnworks_packing_option_confirm** — Confirm a packing option for a given shipping plan in Linnworks. Returns the operation record (OperationModel) with its id and operationType (ConfirmingPackingOptions=3); track progress via the FBA inbound operations endpoints. Required: shipping_plan_id, option_id.
- **create_a_linnworks_packing_options_generate** — Generate packing options for a given FBA inbound shipping plan in Linnworks. Returns the generated operation record including its id and operation type, which can be polled through the FBA inbound operations endpoints. Required: shipping_plan_id.
- **list_all_linnworks_shipping_plan_placement_options** — List the generated placement options for a Linnworks FBA inbound shipping plan. Returns: placementOptionId, expirationDate, status, fees, discounts, shipments. Required: shipping_plan_id.
- **update_a_linnworks_shipping_plan_placement_option_by_id** — Save (confirm) a placement option for a Linnworks FBA inbound shipping plan. Returns: id, entityId, status, type, createdDate, problems, amazonOperationId. Required: id, shipping_plan_id.
- **create_a_linnworks_placement_option_confirm** — Confirm a placement option for a given FBA inbound shipping plan in Linnworks. Returns the operation record with its id and type. Required: shipping_plan_id, option_id.
- **create_a_linnworks_placement_options_generate** — Generate placement options for a given Linnworks FBA inbound shipping plan. Returns the operation object describing the triggered generation, including its id (the full field shape is defined by the upstream OperationModel schema). Required: shipping_plan_id.
- **list_all_linnworks_shipping_plan_boxes** — List the shipment boxes for a Linnworks FBA inbound shipping plan. Returns the shipping plan's box records (upstream ShipmentBoxModel), each including its box id. Required: shipping_plan_id.
- **create_a_linnworks_shipping_plan_box** — Add one or more boxes to a Linnworks FBA inbound shipping plan. The body is a bare JSON array of box definitions (AddShipmentBoxModel); returns the shipping plan's box records including their ids. Required: shipping_plan_id.
- **delete_a_linnworks_shipping_plan_box_by_id** — Remove a box from a Linnworks FBA inbound shipping plan by id. Returns an empty 204 response on success. Required: id, shipping_plan_id.
- **linnworks_shipping_plan_boxes_bulk_update** — Update boxes on a Linnworks FBA inbound shipping plan. The body is a bare JSON array of box updates (UpdateShipmentBoxModel); returns the shipping plan's updated box records including their ids. Required: shipping_plan_id.
- **list_all_linnworks_shipping_plan_box_items** — List the box items for an FBA inbound shipping plan in Linnworks. Returns an array of box item records (upstream model ShipmentBoxItemExtendedModel), each carrying its integer id plus an attributes object; the full field list of that model is not published in the Linnworks API reference. Required: shipping_plan_id.
- **create_a_linnworks_box_item_assigned_item** — Assign an item from a source box to a destination box with a given quantity in a Linnworks FBA inbound shipping plan. Sends a JSON request body matching the upstream AssignItemToBoxRequest schema and returns the upstream AssignItemToBoxResponse result object; the individual field names of both payloads are not enumerated in the discovered source, so consult the Linnworks API reference for the…. Required: shipping_plan_id, shipment_box_item_id, destinationBoxId, quantity.
- **list_all_linnworks_shipment_box_trackings** — List the box trackings for a FBA inbound shipment in linnworks. Returns each box tracking record with its id and model-specific attributes (the upstream ShipmentBoxTrackingExtendedModel fields). Required: shipping_plan_id, shipment_id.
- **update_a_linnworks_shipment_box_tracking_by_id** — Update tracking details for a given box on a linnworks FBA inbound shipment. Returns the updated box tracking record with its id and model-specific attributes. Required: id, shipping_plan_id, shipment_id.
- **list_all_linnworks_shipment_delivery_window_options** — List the delivery window options Amazon generated for a single Linnworks FBA inbound shipment. Returns delivery window option records including their id and attributes (option detail fields defined by the upstream schema). Required: shipping_plan_id, shipment_id.
- **get_single_linnworks_shipment_delivery_window_option_by_id** — Get the saved/selected delivery window option for a Linnworks FBA inbound shipment. Returns the option record including its id and attributes (option detail fields defined by the upstream schema). Required: id, shipping_plan_id.
- **create_a_linnworks_delivery_window_options_generate** — Generate available delivery window options for a shipment in a Linnworks FBA inbound shipping plan. Returns an operation record with its id and operation-specific attributes, which can be tracked via the FBA inbound operations endpoints. Required: shipping_plan_id, shipment_id.
- **create_a_linnworks_delivery_window_option_confirm** — Confirm a delivery window option for a given FBA inbound shipment in linnworks. Returns the OperationModel confirmation result; the upstream reference does not enumerate its fields. Required: shipping_plan_id, shipment_id, delivery_window_option_id.
- **list_all_linnworks_shipments_items** — List the shipment items of an FBA inbound shipping plan in Linnworks. Returns an array of shipment item records, each including an id and an attributes object with the upstream ShipmentItemResponse fields. Required: shipping_plan_id.
- **create_a_linnworks_shipments_item** — Create shipment items in bulk for an FBA inbound shipping plan in Linnworks. Returns an array of the created shipment item records, each including an id and an attributes object with the upstream ShipmentItemResponse fields. Required: shipping_plan_id, items.
- **update_a_linnworks_shipments_item_by_id** — Update a shipping plan item in Linnworks by id. Returns an empty 204 response on success. Required: id, shipping_plan_id, stockItemId, quantityToShip, shipmentId.
- **linnworks_shipments_items_bulk_delete** — Delete specific shipment items of an FBA inbound shipping plan in Linnworks. Returns an empty 204 response on success. Required: shipping_plan_id, shipmentItemIds.
- **linnworks_item_quantities_bulk_update** — Update the quantity of a shipment item in a linnworks FBA inbound shipping plan. Returns the updated shipment item record with its id and attributes (upstream ShipmentItemResponse). Required: shipping_plan_id, shipment_item_id.
- **linnworks_prep_instructions_prep_owners_bulk_update** — Update the prep owner (who will prepare the item) for shipment items in a Linnworks FBA inbound shipping plan. Returns the updated shipment item records defined by the upstream ShipmentItemResponse schema (its fields are not enumerated in the API reference). Requires shipping_plan_id and a JSON request body (UpdateShipmentItemPrepOwnerRequestInput). Required: shipping_plan_id.
- **linnworks_prep_instructions_label_owners_bulk_update** — Update the label owner for shipment items in a Linnworks FBA inbound shipping plan, specifying who will label the items. Returns the updated shipment item record including its id. Required: shipping_plan_id.
- **create_a_linnworks_items_import** — Import shipment items into a Linnworks FBA inbound shipping plan. Returns the upstream ImportShipmentItemsResponse object; its fields are defined by Linnworks and not enumerated in the available docs. Required: shipping_plan_id, fileId, settings.
- **linnworks_items_prep_categories_bulk_update** — Set the prep category and prep type for shipment items on an FBA inbound shipping plan in linnworks. Returns the operation status object for the SetPrepDetails operation. Required: shipping_plan_id, items.
- **linnworks_items_expiration_dates_bulk_update** — Update the expiration date of shipment items in a Linnworks FBA inbound shipping plan. Returns the updated shipment item records (id), shaped per the upstream ShipmentItemResponse schema. Required: shipping_plan_id.
- **create_a_linnworks_items_batch** — Add an item batch to a shipment of an FBA inbound shipping plan in Linnworks to set its item batch quantity. Returns a boolean success result. Required: shipping_plan_id, batches, fromLocation, shipmentItemId.
- **list_all_linnworks_shipment_pallets** — List the pallets on an FBA inbound shipment in linnworks. Returns shipment pallet records including their numeric id and upstream-defined pallet attributes. Required: shipment_id, shipping_plan_id.
- **create_a_linnworks_shipment_pallet** — Add one or more pallets to an FBA inbound shipment in linnworks by posting a JSON array of pallet objects. Returns the created shipment pallet records including their numeric id and upstream-defined pallet attributes. Required: shipment_id, shipping_plan_id.
- **delete_a_linnworks_shipment_pallet_by_id** — Remove a pallet from an FBA inbound shipment in linnworks by id. Returns an empty 204 response on success. Required: id, shipment_id, shipping_plan_id.
- **update_a_linnworks_shipment_pallet_by_id** — Update a pallet on an FBA inbound shipment in linnworks by sending a JSON array of patch operations. Returns the updated shipment pallet record including its numeric id and upstream-defined pallet attributes. Required: id, shipment_id, shipping_plan_id.
- **get_single_linnworks_shipment_pallet_by_id** — Get a specific pallet on an FBA inbound shipment in linnworks by id. Returns shipment pallet records including their numeric id and upstream-defined pallet attributes. Required: id, shipment_id, shipping_plan_id.
- **list_all_linnworks_shipping_plan_shipments** — List the Linnworks FBA inbound shipments belonging to a specific shipping plan. Returns an array of shipment records (upstream ShipmentResponse), each with a numeric id; the docs do not enumerate the other record fields. Required: shipping_plan_id.
- **get_single_linnworks_shipping_plan_shipment_by_id** — Get a single Linnworks FBA inbound shipment by id within a shipping plan. Returns the shipment record (upstream ShipmentModel) including its numeric id; the Linnworks docs do not enumerate the record's other fields. Required: id, shipping_plan_id.
- **list_all_linnworks_shipment_pallet_labels** — Get the pallet label download URLs for a specific shipment in a Linnworks FBA inbound shipping plan. Returns the label URL(s) ready for printing. Required: shipment_id, shipping_plan_id.
- **get_single_linnworks_shipment_bill_of_lading_by_id** — Get the bill of lading PDF document data for printing an FBA inbound shipment in Linnworks. Returns the bill of lading document data as a single JSON object with document-data-specific fields. Required: id, shipping_plan_id.
- **create_a_linnworks_shipment_tracking_detail** — Apply tracking information to an FBA inbound shipment in Linnworks (SendShipmentTrackingDetails). Returns the async operation record including its id and upstream operation attributes. Required: shipping_plan_id, shipment_id.
- **list_all_linnworks_shipment_transport_details** — Get the transportation details for a shipment within a Linnworks FBA inbound shipping plan. Returns the transport details record with its id and upstream-defined transportation detail attributes. Required: shipment_id, shipping_plan_id.
- **list_all_linnworks_shipment_box_items** — List the box items for a shipment in a Linnworks FBA inbound shipping plan. Returns: sku, title. Required: shipping_plan_id, shipment_id.
- **create_a_linnworks_fba_inbound_shipping_plan** — Create an FBA inbound shipping plan with a default shipment in Linnworks. Returns the created shipping plan card response (upstream GetShippingPlanCardsResponse schema). Required: fromLocationId, toLocationId.
- **get_single_linnworks_fba_inbound_shipping_plan_by_id** — Get a single FBA inbound shipping plan by id, including its shipments and shipping items. Returns the shipping plan response defined by Linnworks' GetShippingPlanByIdResponse schema. Required: id.
- **update_a_linnworks_fba_inbound_shipping_plan_by_id** — Update an FBA inbound shipping plan by id in Linnworks. Returns the updated shipping plan card response (upstream GetShippingPlanCardsResponse schema). Required: id, channelId, fromLocation, toLocation.
- **delete_a_linnworks_fba_inbound_shipping_plan_by_id** — Delete an FBA inbound shipping plan by id, removing it with related info and returning reserved stock back into inventory. Returns an empty 204 response on success. Required: id.
- **linnworks_shipping_plan_submits_bulk_update** — Submit an FBA inbound shipping plan in Linnworks by id. Returns the shipping plan cards payload with its id and schema-specific attributes (Linnworks references a cards response schema without enumerating its fields). Required: shipping_plan_id.
- **create_a_linnworks_shipping_plan_packing_information** — Apply packing information to an FBA inbound shipping plan in linnworks. Returns the operation record with its id (UUID) and type (operation kind, e.g. 10 = SettingPackingInfo); the operation can be polled via the fba-inbound operations endpoints. Required: shipping_plan_id.
- **list_all_linnworks_shipping_plan_prep_instructions** — Get generated prep instructions for an FBA inbound shipping plan in linnworks. Returns the prep-instructions response payload with upstream-defined fields (not enumerated in the source documentation). Required: shipping_plan_id.
- **create_a_linnworks_shipping_plan_prep_instruction** — Get and save prep instructions from Amazon for an FBA inbound shipping plan in linnworks. Returns the Amazon-defined prep-instructions response payload with upstream-defined fields (not enumerated in the source documentation). Required: shipping_plan_id.
- **list_all_linnworks_shipping_plan_delivery_informations** — Get delivery information for a specific FBA inbound shipping plan in Linnworks. Returns a JSON array of delivery-information records for the plan (upstream GetDeliveryInformationResponse objects). Required: shipping_plan_id.
- **linnworks_shipping_plan_delivery_window_options_bulk_update** — Save the delivery window option for a shipment in a Linnworks FBA inbound shipping plan. Returns the created operation record with its id and an attributes object of operation fields; track it via the FBA inbound operations endpoints. Required: shipping_plan_id.
- **list_all_linnworks_stock_items_batches** — List the stock item batches for the items of a specific FBA inbound shipping plan in linnworks. Returns an array of stock item batch records (upstream schema StockItemBatchResponse; the docs do not enumerate the record fields). Required: shipping_plan_id.
- **create_a_linnworks_transfer_cards_archive** — Archive one or more closed or delivered FBA inbound shipments in Linnworks by posting an ArchiveShipmentsRequest body. Returns an empty 200 response on success.
- **list_all_linnworks_transfer_cards_shipping_plans** — List shipping plan transfer cards for FBA inbound in linnworks. Returns an array of card records, each with an id and its attributes (the card fields as defined by the upstream GetShippingPlanCardsResponse schema). No required parameters.
- **get_single_linnworks_transfer_cards_shipping_plan_by_id** — Get a single shipping plan transfer card by id in linnworks. Returns the card record with id and attributes (the card fields as defined by the upstream GetShippingPlanCardsResponse schema). Required: id.
- **list_all_linnworks_transfer_cards_shipments** — List FBA inbound transfer card shipments in Linnworks (GetShipmentCards). Returns: cards. No required parameters.
- **create_a_linnworks_transfer_cards_refresh** — Start the refresh process for FBA inbound shipment cards in linnworks. Requires no request parameters. Returns a JSON response confirming the refresh was started; its fields are defined by the upstream RefreshShipmentCardsResponse schema and are not enumerated in the API documentation.
- **get_single_linnworks_warehousetransfer_transfer_by_id** — Get a warehouse transfer in Linnworks by its unique id. Returns the transfer record's id and attributes (the full WarehouseTransferModel fields defined upstream). Required: id.
- **create_a_linnworks_transport_options_estimate** — Generate transportation options for the shipments of a Linnworks FBA inbound shipping plan. Returns an OperationModel object describing the generation operation (the available documentation does not enumerate its fields; the operation can be tracked via the FBA inbound operations endpoints). Required: shipping_plan_id, placementOptionId, shipmentTransportationConfigurations.
- **list_all_linnworks_shipment_transport_options** — List the generated transportation options for a shipment within a Linnworks FBA inbound shipping plan. Returns a list of transportation option objects (upstream TransportationOptionModel; the API reference does not document their individual fields). Required: shipping_plan_id, shipment_id.
- **create_a_linnworks_transport_options_confirm** — Confirm transportation options for shipments of a linnworks FBA inbound shipping plan. Returns the confirmation operation with its id and type; the resulting operation can be tracked via the linnworks fba-inbound operations endpoints. Required: shipping_plan_id.
- **linnworks_shipments_transport_options_bulk_update** — Save transportation options for shipments of a Linnworks FBA inbound shipping plan. Returns an empty response body on success. Required: shipping_plan_id.
- **list_all_linnworks_packing_group_box_items** — List the box items that belong to a packing group in a Linnworks FBA inbound shipping plan. Returns each box item record's id plus its attributes; the full field set is defined by the upstream ShipmentBoxItemExtendedModel schema. Required: shipping_plan_id, packing_group_id.
- **list_all_linnworks_shipment_boxes** — List the shipment boxes for a specific shipment in a Linnworks FBA inbound shipping plan. Returns each box with its id and attributes (upstream ShipmentBoxModel fields). Required: shipping_plan_id, shipment_id.
- **list_all_linnworks_shipment_labels** — Get the package label URLs for a specific shipment in an Linnworks FBA inbound shipping plan. Returns a label response with its id and upstream-defined attributes containing the package label URLs for the requested boxes. Required: shipment_id, shipment_box_ids, shipping_plan_id.

## How it works

1. **Link your customer's Linnworks account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Linnworks.** The Proxy API is a 1-to-1 mapping of the Linnworks API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Power demand forecasting and automated purchasing** — Give merchants an intelligent replenishment layer that pulls sales history and stock levels from Linnworks, then writes purchase orders back to suppliers natively. Your SaaS owns the forecasting math while Linnworks stays the source of truth for procurement.
- **Offer branded returns and RMA workflows** — Let end users trigger refunds, exchanges, and RMA bookings from your post-purchase portal while the operations team sees every return land inside Linnworks in real time. Eliminates dual data entry between the returns SaaS and the OMS.
- **Ship a 3PL or FBA prep center control tower** — Fetch open orders scoped to a warehouse location, generate pickwaves, and confirm FBA shipping plans, boxes, and pallets on behalf of the merchant. Ideal for fulfillment software that needs to close the loop by processing orders once shipped.
- **Add live order context to helpdesk and CX tools** — Surface order status, shipping info, and line items inside support tickets, and let agents cancel, lock, or edit orders without leaving your UI. Reduces tab-switching and prevents fulfillment of orders the customer already wants stopped.
- **Sync catalog, pricing, and supplier data from a PIM** — Push new SKUs, images, titles, descriptions, and channel-specific pricing rules into Linnworks so merchants can list across marketplaces from a single catalog source. Keeps supplier stats and identifiers consistent across systems.

## What you can build

- **Two-way order sync with lifecycle actions** — Pull open and processed orders, then trigger process, cancel, split, merge, lock, and status change actions directly from your app.
- **Real-time stock level writeback** — Read stock by location and bulk update stock levels via SKU so your app can adjust inventory after receipts, scrap events, or third-party fulfillment activity.
- **Purchase order automation** — Create purchase orders from inventory forecasts, add or modify line items in bulk, and mark items as delivered to keep receiving flows in sync with supplier stats.
- **Returns, refunds, and exchange orchestration** — Fetch refund and return options, create RMA bookings, issue refunds, and generate exchange or resend orders through a single unified workflow.
- **FBA inbound shipping plan builder** — Programmatically create FBA shipping plans, confirm packing and placement options, assign box and pallet contents, and retrieve pallet labels and bills of lading.
- **Warehouse transfers and pickwave management** — Generate pickwaves, allocate items to binracks, and manage multi-location warehouse transfers with request, sent, and received quantity tracking.

## FAQs

### How does authentication work for Linnworks through Truto?

Truto handles the Linnworks application authorization flow so your end users connect their Linnworks account via a hosted or embedded flow. Token acquisition, refresh, and secure storage are managed by Truto — you never touch application secret keys directly.

### Can we read both open and processed (historical) orders?

Yes. You can search and paginate open orders, retrieve full order details by order or reference ID, and run searches over processed orders including audit trails, notes, extended properties, and refund history.

### Does the integration support Linnworks' Rules Engine?

Yes. You can list rules, evaluators, actions, and condition nodes, create and swap conditions, add or update actions, toggle rules and conditions on and off, and test-evaluate rules before promoting a draft to live.

### How do we handle multi-warehouse and 3PL scenarios?

Open orders can be filtered by user location IDs, and you have full access to warehouse transfers, stock locations, binracks, pickwaves, and totes. This lets you scope reads and writes to a specific fulfillment center or 3PL location.

### Can we manage custom fields and metadata on orders and inventory?

Yes. Linnworks exposes extended properties on both orders and inventory items — you can list property names and types, and create, update, or delete values. Order-level tags, notes, and identifiers are also supported.

### Is FBA-specific functionality available via the API?

Yes. The integration exposes deep FBA inbound support including shipping plan creation, packing and placement option generation and confirmation, box and pallet management, delivery windows, transport options, tracking details, and bill of lading retrieval.

## Related reading

- [Connect Linnworks to Claude: Sync Stocks and Sales Channel Listings](https://truto.one/blog/connect-linnworks-to-claude-sync-stocks-and-sales-channel-listings/) — Learn how to connect Linnworks to Claude using an MCP server. Automate inventory syncs, order processing, and warehouse transfers using natural language.
- [Connect Linnworks to ChatGPT: Manage Inventory, Orders, and Shipping](https://truto.one/blog/connect-linnworks-to-chatgpt-manage-inventory-orders-and-shipping/) — Learn how to build a secure, dynamic MCP server for Linnworks using Truto. Give ChatGPT the ability to read inventory, write POs, and orchestrate orders.
- [Connect Linnworks to AI Agents: Automate Returns, FBA, and Logistics](https://truto.one/blog/connect-linnworks-to-ai-agents-automate-returns-fba-and-logistics/) — Learn how to connect Linnworks to AI agents using Truto's /tools endpoint. Bind native tools to LLMs for autonomous returns, FBA, and logistics workflows.
