> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateShippingBox

> Creates a new shipping box within a warehouse.

If a request with this mutation's Idempotency-Key was already completed, the response's `extensions` contains an `idempotency.{responseName}` entry with `wasReplayed: true`.



**mutation** `CreateShippingBox(request: CreateShippingBoxCommandRequestInput!): CreateShippingBoxCommandResponse!`

## Arguments

**`request`**: `CreateShippingBoxCommandRequestInput!` (required)

## Returns

`CreateShippingBoxCommandResponse!`

**`shippingBoxId`**: `ID!`

The ID of the newly created shipping box.

## Examples

```graphql Mutation
mutation CreateShippingBox($request: CreateShippingBoxCommandRequestInput!) {
  CreateShippingBox(request: $request) {
    shippingBoxId
  }
}
```

```json Variables
{
  "request": {
    "warehouseId": "id",
    "displayId": "string",
    "typeId": "id",
    "binLocationId": "id",
    "attributes": [
      "string"
    ]
  }
}
```

```json Response
{
  "data": {
    "CreateShippingBox": {
      "shippingBoxId": "id"
    }
  }
}
```
