# products_link_listings (https://sellersheetai.com/docs/mcp-api/tools/products_link_listings)

> Link listings of one store to local SKUs, with the number of units one sale takes.

Access: **WRITE** · toolset sellersheet · family null

Gate: approve — interactive: show the change (SellerSheet's preview first where one exists), wait for an explicit approve; autopilot: only when the seller's own words asked for this change; otherwise ask. The server checks each listing against the store's newest listings report and returns the proof. Linking a listing again to the same SKU changes the link; a listing held by another SKU is refused, naming that SKU. One SKU may hold several listings on one store.

## Call it

MCP tool call:

```json
{
  "name": "products_link_listings",
  "arguments": {
    "store": "myStore-US",
    "links": []
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/products_link_listings \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","links":[]}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `store` | string | yes | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. With channel noon: one of its noon store_refs. |
| `links` | object[] | yes | 1 to 50 rows. Each row: sku (the local SKU code), listing_sku (the platform's SKU, as the report spells it), units_per_listing (how many of the local SKU one sold unit contains, 1 to 10,000: 1 when the local SKU is the whole pack, 2 when a 2-pack is made of two of it; required when the listing's SKU or title carries a pack word and its SKU is not the local code; default 1 otherwise), fnsku (only when the platform's report has none), allow_unverified (true links a listing that is not in the report, marked not verified), platform_holds_stock (default: what the report says), listing_id (the ASIN or Z-SKU; must equal the report's when the listing is in it). |
| `channel` | string |  | amazon (default) or noon. Allowed: amazon \| noon. |

## Result

- `data.report_date` — The date of the listings report used.
- `data.rows` — sku, listing_sku, result (linked, updated, unchanged or refused), link_id, units_per_listing, match (code_equal, in_report or unverified), match_checked_on, listing_id, title, fnsku, fnsku_source, platform_holds_stock, pack_hint, pack_hint_text, and for a refused row error_code and message. data.linked, data.updated, data.unchanged, data.refused: Counts.

## Workflow

- products_list_listings first. Show the seller every row (SKU, listing, title, units) before calling. products_unlink_listing ends a link.