Skip to main content
Who this is for: Brand administrators. Go to Settings → Integrations → Lynk.
Lynk is a warehouse management API (https://api.lynksupplychain.com production, https://api.stage-lynksupplychain.com staging). Connecting an API key does not start exclusive OMS replace or every sync — each write path is an independent toggle.

​
Independent toggles

If push orders is on and decoration merge is off, Lynk replaces Shopify as the OMS (same exclusive pattern as Luminous). Luminous push and Lynk push cannot both be on. Decoration merge is the only dual-write: individual Shopify orders stay on fulfillment hold. A Lynk CLOSED fulfillment is warehouse → decorator. Keystone stores tracking on the decoration transfer order (or legacy embroidery batch) and does not create customer item_fulfillments or auto-fulfill Shopify children.

​
Decoration transfer orders (primary path)

Use this flow to batch decoration-eligible sales orders and push one Lynk work order from the warehouse to your decorator.
  1. Settings → Custom Decorations — set the default decorator ship-to (address, city, country). This pre-fills new decoration transfer orders.
  2. Settings → Integrations → Lynk — connect your API key, turn on Decoration merge, set Channel name and Expected channel fulfillment mode, and review Auto-process decorator work orders (default on → Lynk pending). Set the decorator contact email on the Lynk card (required as the Lynk order email on push). Optionally adjust Decoration eligibility tags.
  3. Sales Orders — filter or select decoration-eligible orders, then Add to Transfer Order. Keystone creates or appends to an open decoration transfer (transfer_purpose=decoration) under Ops → Transfer Orders.
  4. Transfer Order detail — confirm ship-to and line items, then Push to Lynk. Keystone posts a warehouse→decorator work order, locks the transfer order, and moves linked sales orders to Sent to decorator. The Lynk order is tagged with the wire value Lynk-embroidery (do not rename this tag string in Shopify or Lynk).
  5. Tracking — fulfillment and shipment sync writes tracking onto the transfer order. Lynk CLOSED does not auto-fulfill Shopify children.
Push requires Decoration merge enabled, a complete decorator ship-to on the transfer order, at least one line item, and the decorator contact email on the Lynk integration card.

​
Legacy: embroidery merge queue (alternate)

Some tenants still use the in-app merge queue on the Lynk settings page (LynkEmbroideryQueue):
  1. Turn on Decoration merge and set decorator ship-to on the Lynk card (legacy merge path).
  2. Eligible pending orders still go to Shopify and are tagged Lynk-embroidery with fulfillment orders held.
  3. Confirm designs in the Decoration merge queue, then merge selected orders into one Lynk work order.
  4. Hourly fulfillment sync (or Sync fulfillments) pulls Lynk status/tracking onto the batch. Shopify children remain unfulfilled.
Prefer the decoration transfer order path for new work — it groups sales orders explicitly and tracks status on the transfer order in Ops.

​
Connecting

  1. Go to Settings → Integrations → Lynk.
  2. Choose Production or Staging.
  3. Enter your Lynk API key (Bearer) and Test connection.
  4. Save, then turn on only the toggles you need. Connecting a key alone does not enable exclusive OMS.
  5. For incoming inventory or in-stock now, map sources under Settings → Inventory.
The API key is write-only after save. The form shows a masked placeholder instead of echoing the secret.

​
Out of scope / not used

Keystone does not call these Lynk APIs today. Do not expect them in the product:
  • Shipments as seller — seller-side shipment endpoints are not integrated; tracking comes from fulfillment/shipment sync on pushed orders only.
  • Order action endpoints — Keystone does not POST Lynk order actions (for example manual RELEASE from the UI). Work orders are created with the configured post mode; stuck DRAFT release is handled in Lynk admin unless auto-process is on.