---
title: "Creates a new shipping box within a warehouse."
method: POST
path: "/v2/warehouseassistant/shipping-boxes/create"
tags: ["WarehouseAssistantCommand"]
---

# Creates a new shipping box within a warehouse.

`POST /v2/warehouseassistant/shipping-boxes/create`

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Request body

- JTLWawiWarenlagerverwaltungPublicApiDataTransferObjectsV2WarehouseAssistantCreateShippingBoxCommandRequest — Creates a new shipping box within a warehouse. - Request
  - `warehouseId` string, uuid
  - `displayId` string — Display name for the box (must be unique within warehouse).
  - `typeId` string, uuid — Represents a unique key for identifying a lhm type in the JTL system.
  - `binLocationId` string, uuid
  - `attributes` string[] — Optional list of free-form attributes.

## Response `201`

Shipping box was successfully created.

## Other responses

- `500` — Internal server error.

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)