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

# CreateChannelMapping

`POST /api/Inventory/CreateChannelMapping`

## Request

- Base URL: `https://eu-ext.linnworks.net`
- URL: `https://eu-ext.linnworks.net/api/Inventory/CreateChannelMapping`
- Auth: API key in header `Authorization`

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.dev/linnworks/apis/inventory-api.md) - [All operations](https://skmtc.dev/linnworks/apis/inventory-api/llms.txt) - [OpenAPI document](https://skmtc.dev/linnworks/apis/inventory-api/revisions/3d2d6f37b533?raw)