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

# CreateNewBin

`POST /api/WarehouseTransfer/CreateNewBin`

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.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)