---
title: "CreateNewBin"
method: POST
path: "/api/WarehouseTransfer/CreateNewBin"
tags: ["WarehouseTransfer"]
---

# CreateNewBin

`POST /api/WarehouseTransfer/CreateNewBin`

## Request

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

Use this call to create a new bin.
<b>Permissions Required: </b> GlobalPermissions.Inventory.WarehouseTransferNode
<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

- WarehouseTransferCreateNewBinRequest
  - `pkTransferId` string, uuid: The transfer to create the bin for.
  - `barcode` string: The barcode of the bin.

## Response `200`

OK

- WarehouseTransferBin
  - `PkBinId` string, uuid: Bin ID
  - `BinName` string: Transfer bin name
  - `BinReference` string: Bin reference
  - `BinBarcode` string: Bin barcode
  - `BinNotes` WarehouseTransferBinNote[]: List of transfer bin notes
    - `PkTransferBinNoteId` string, uuid: Transfer bin note ID
    - `NoteUser` string: User who created note
    - `Note` string: Note text
    - `NoteDateTime` string, date-time: When bin note was added
    - `NoteRead` boolean: If bin note is readable
    - `PkBinId` string, uuid: Bin ID
  - `BinItems` WarehouseTransferItem[]: List of transfer items
    - `PkTransferItemId` string, uuid: Transfer ID
    - `FkStockItemId` string, uuid: Stock item ID (unique identifier)
    - `SKU` string: Product SKU
    - `Barcode` string: Product barcode
    - `ItemTitle` string: Product title
    - `RequestedQuantity` integer: Quantity requested for transfer
    - `SentQuantity` integer: Quantity transferred
    - `ReceivedQuantity` integer: Quantity received
    - `InFromLocationQuantity` integer: Quantity from location
    - `DueFromLocationQuantity` integer: Due from location quantity
    - `InToLocationQuantity` integer: Currently in location quantity
    - `ItemNoteCount` integer: Items notes count
    - `BinRackNumber` string: Stock item binrack
    - `PkBinId` string, uuid: Transfer bin ID
    - `ItemNotes` WarehouseTransferItemNote[]: List of transfer notes
      - `PkTransferItemNoteId` string, uuid: Stock item ID (unique identifier)
      - `NoteUser` string: User who added note
      - `Note` string: Note text
      - `NoteDateTime` string, date-time: When note was added
      - `NoteRead` boolean: If note is readable
      - `FkBinId` string, uuid: Bin ID
      - `PkTransferItemId` string, uuid: Transfer ID

---

[API](https://skmtc.dev/linnworks/apis/warehouse-transfer-legacy-api.md) - [All operations](https://skmtc.dev/linnworks/apis/warehouse-transfer-legacy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/linnworks/apis/warehouse-transfer-legacy-api/revisions/9da4438112ba?raw)