---
title: "CreateChannelMapping"
method: POST
path: "/api/Inventory/CreateChannelMapping"
tags: ["Inventory"]
---

# CreateChannelMapping

`POST /api/Inventory/CreateChannelMapping`

Use this call to create mappings between Linnworks items and channel items
<b>Rate limit: </b><span style="background-color:#0272d9;color:white;padding:4px 8px;text-align:center;border-radius:5px; font-size: small;"><b>150</b></span> / minute

## Request body

- CreateChannelMappingRequest
  - `Mappings` ChannelMappingCreateInfo[]
    - `Id` string, uuid — RowId of channel SKU, will be created if not in the request
    - `StockItemId` string, uuid, required — The stock item id
    - `ChannelSKU` string, required — The SKU as exists on the channel
    - `Source` string, required — ChannelName/Source (e.g. EBAY)
    - `SubSource` string, required — Region code
    - `ChannelReferenceId` string — Channel reference ID
    - `MaxListedQuantity` integer — Maximum listed quantity
    - `EndWhenStock` integer — End listing when stock level
    - `StockPercentage` number, double — Stock percentage
    - `IgnoreSync` boolean — Ignore sync, defaults to false

## Response `200`

OK

- BatchedAPIResponseChannelMappingCreateInfo
  - `Results` APIResultResponseChannelMappingCreateInfo[]
    - `Result` ChannelMappingCreateInfo
      - `Id` string, uuid — RowId of channel SKU, will be created if not in the request
      - `StockItemId` string, uuid, required — The stock item id
      - `ChannelSKU` string, required — The SKU as exists on the channel
      - `Source` string, required — ChannelName/Source (e.g. EBAY)
      - `SubSource` string, required — Region code
      - `ChannelReferenceId` string — Channel reference ID
      - `MaxListedQuantity` integer — Maximum listed quantity
      - `EndWhenStock` integer — End listing when stock level
      - `StockPercentage` number, double — Stock percentage
      - `IgnoreSync` boolean — Ignore sync, defaults to false
    - `ResultStatus` 'NOTSET' | 'SUCCESSFUL' | 'PARTIALLY_SUCCESSFUL' | 'FAILED'
    - `Message` string
  - `TotalResults` integer
  - `ResultStatus` 'NOTSET' | 'SUCCESSFUL' | 'PARTIALLY_SUCCESSFUL' | 'FAILED'

---

[API](https://skmtc.net/linnworks/apis/authenticate-api.md) · [All operations](https://skmtc.net/linnworks/apis/authenticate-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linnworks/authenticate-api/versions/0123569a22fb/schema)