> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keystoneb2b.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lynk Integration

> Connect Lynk WMS for ASNs, warehouse inventory, order push, fulfillments, and embroidery merge.

<Note>
  **Who this is for:** Brand administrators. Go to **Settings → Integrations → Lynk**.
</Note>

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

| Toggle              | Default | What it does                                                                                                                                                                                                                                                                               |
| ------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Purchase orders     | On      | Pull Lynk ASNs (`GET /supply/v1/asns`) into Keystone purchase orders (incoming inventory)                                                                                                                                                                                                  |
| Warehouse inventory | Off     | Write Lynk on-hand and available (`GET /inventory/v1/inventories`) into product warehouse fields                                                                                                                                                                                           |
| Push orders         | Off     | POST Keystone pending orders to Lynk (`POST /sales/v1/orders`) instead of Shopify. Exclusive OMS — do not combine with Luminous push.                                                                                                                                                      |
| Sync fulfillments   | Off     | Pull fulfillments for Keystone-pushed Lynk orders (`GET /sales/v1/fulfillments`) plus shipment tracking (`GET /shipping/v1/shipments`)                                                                                                                                                     |
| Embroidery merge    | Off     | Shopify children stay on fulfillment hold. Operators merge into one Lynk work order shipped warehouse → embroiderer. **Does not turn on exclusive order push.** Merge posts the work order even when Push orders is off. Fulfillment pull for those work orders runs whenever merge is on. |

If **push orders** is on and embroidery merge is off, Lynk replaces Shopify as the OMS (same exclusive pattern as Luminous). Luminous push and Lynk push cannot both be on.

Embroidery merge is the only dual-write: individual Shopify orders stay on fulfillment hold. A Lynk `CLOSED` fulfillment is warehouse → embroiderer. Keystone stores tracking on the embroidery batch and does **not** create customer `item_fulfillments` or auto-fulfill Shopify.

## Embroidery path (Dr Woof)

1. Turn on **Embroidery merge**. Set embroiderer ship-to (address, city, email). Optionally set eligibility tags (default `embroidery`).
2. Eligible pending orders still go to Shopify and are tagged `Lynk-embroidery` with fulfillment orders held.
3. Confirm designs, then merge selected orders. Keystone `POST`s a Lynk sales order to the embroiderer.
4. Hourly fulfillment sync (or **Sync fulfillments**) pulls Lynk status/tracking onto the batch. Shopify children remain unfulfilled.

## 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**.

<Warning>
  The API key is write-only after save. The form shows a masked placeholder instead of echoing the secret.
</Warning>

## Related

* [Integrations overview](/integrations/overview)
* [Inventory & ATS](/app-guide/inventory)