---
title: "Create inbound shipments in Zentail"
method: POST
path: "/inbound-shipment"
tags: ["InboundShipment"]
---

# Create inbound shipments in Zentail

`POST /inbound-shipment`

## Request

- Base URL: `https://api.zentail.com/v1`
- URL: `https://api.zentail.com/v1/inbound-shipment`
- Auth: API key in header `AUTHORIZATION`

Create an inbound shipment in Zentail from a set of product information. Must include status,
                            vendor name, destination warehouse, and purchase order number.

## Request body

- InboundShipmentPostRequest
  - `inbound_shipment_products` InboundShipmentProductData[], required
    - `product_id` number, required
    - `sku` string, required
    - `quantity` number, required
    - `unit_item_cost` number
  - `status` 'PENDING' | 'SHIPPED' | 'RECEIVED' | 'PARTIALLY_RECEIVED' | 'CANCELLED', required: The status of the inbound shipment.
  - `vendor_name` string, required
  - `destination_warehouse_id` integer, required
  - `shipping_cost` number
  - `purchase_order_number` string, required

## Response `200`

Success

- InboundShipmentSummary
  - `inbound_shipment_id` number: A unique identifier for this inbound shipment.
  - `status` string
  - `vendor_name` string
  - `destination_warehouse_name` string
  - `shipping_cost` number
  - `purchase_order_number` string
  - `created_ts` string, date-time
  - `shipped_ts` string, date-time
  - `estimated_delivery_ts` string, date-time

## Other responses

- `400`: Bad Request
- `403`: Permission Denied
- `404`: Not Found
- `500`: Zentail Error
- `503`: Zentail Error

---

[API](https://skmtc.dev/zentail/apis/zentail-api.md) - [All operations](https://skmtc.dev/zentail/apis/zentail-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zentail/apis/zentail-api/revisions/55e43cb43caf?raw)