---
title: "Create a new inbound."
method: POST
path: "/inbounds"
tags: ["inbounds"]
---

# Create a new inbound.

`POST /inbounds`

ADD ENDPOINT DESCRIPTION HERE

## Request body

- InboundPost
  - `sellerId` integer, required — Seller ID.
  - `warehouseId` integer, required — Warehouse ID. <br>A list of warehouse identifiers and names can be obtained by executing GET /warehouses
  - `shipFrom` AddressDetail, required
    - `name1` string
    - `name2` string
    - `company` string
    - `address1` string
    - `address2` string
    - `address3` string
    - `zip` string
    - `city` string
    - `state` string
    - `country` string
    - `phone` string
    - `email` string
  - `estimatedArrivalTime` string, date-time, required — Estimated date of arrival
  - `deliverySlipNumber` string, required — Delivery slip number
  - `customAttributes` object — Optional custom attributes of this inbound.
  - `movementReferenceNumber` string — Optional movement reference number. Unique identifier assigned to customs declarations within the UK and EU
  - `inboundPositions` InboundPositionDetailPost[], required — List of inbound positions
    - `quantity` integer, required — Number of units of the position.
    - `sku` string, required — Position SKU.
    - `lot` string — Optional position lot.
    - `location` string — Optional position location.
    - `expirationDate` string, date — Optional position expiration date.
    - `serialNumbers` string[] — Optional position serial numbers.
    - `positionNumber` string — Optional position number or identifier
    - `customAttributes` object — Optional custom attributes of this inbound position.
  - `deliveryInfo` InboundDeliveryInfoDetail, required
    - `cargoType` 'CARTON' | 'PALLET' | 'CONTAINER', required — Cargo type.
    - `quantity` integer, required — Cargo quantity.
  - `trackingNumber` string, required — Optional tracking number
  - `carrier` string — Optional carrier
  - `comments` string — Comments.
  - `deliverySlipDate` string, date-time — Optional date of the creation of the delivery slip
  - `externalIdentifier` string — Optional identifier. Can be a freight number or container number
  - `tags` string[] — Optional tags of this inbound
  - `inboundReference` string — Optional additional reference of this Inbound.

## Response `200`

successful operation

- InboundPostResult
  - `status` string
  - `inboundId` integer
  - `field` string
  - `message` string

---

[API](https://skmtc.net/writechoiceorg/apis/connector.md) · [All operations](https://skmtc.net/writechoiceorg/apis/connector/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/writechoiceorg/connector/revisions/7ce09a4b2a4e/schema)