---
title: "POST /shelf"
method: POST
path: "/shelf"
tags: ["shelf"]
---

# POST /shelf

`POST /shelf`

## Request

- Base URL: `https://www.weclapp.com/api/nullapi/v2`
- URL: `https://www.weclapp.com/api/nullapi/v2/shelf`
- Auth: API key in header `AuthenticationToken`
- TypeScript: <https://skmtc.dev/weclapp/apis/weclapp-api/docs/shelf/post.ts> (a function with typed inputs; its response is checked against the schema)

create a shelf

## Query parameters

- `dryRun` boolean

## Request body

- Shelf
  - `id` string
  - `version` string
  - `active` boolean
  - `createdDate` integer
  - `lastModifiedDate` integer
  - `shortIdentifier` string, required
  - `storageLocationId` string, required
  - `storagePlaces` NestedStoragePlace[], required
    - `id` string
    - `version` string
    - `active` boolean
    - `barcode` string
    - `blockedForResupply` boolean
    - `blockedForResupplyReasonId` string
    - `createdDate` integer
    - `customAttributes` CustomAttribute[]
      - `attributeDefinitionId` string
      - `booleanValue` boolean
      - `dateValue` integer
      - `entityId` string
      - `entityReferences` EntityReference[]
        - `entityId` string
        - `entityName` string
      - `numberValue` string, number
      - `selectedValueId` string
      - `selectedValues` OnlyId[]
        - `id` string
      - `stringValue` string
    - `customerId` string
    - `fieldNumber` integer
    - `lastModifiedDate` integer
    - `levelNumber` integer
    - `name` string, required
    - `pickSequence` integer
    - `storagePlaceSizeId` string
    - `storagePlaceType` 'ASSEMBLY' | 'BLOCKED' | 'BUFFER' | 'CONSOLIDATION' | 'INBOUND' | 'PICKING' | 'STOCK' | 'UNIVERSAL' | 'UNIVERSAL_WITHOUT_PICKING', required

## Response `201`

shelf create response

- Shelf
  - `id` string
  - `version` string
  - `active` boolean
  - `createdDate` integer
  - `lastModifiedDate` integer
  - `shortIdentifier` string, required
  - `storageLocationId` string, required
  - `storagePlaces` NestedStoragePlace[], required
    - `id` string
    - `version` string
    - `active` boolean
    - `barcode` string
    - `blockedForResupply` boolean
    - `blockedForResupplyReasonId` string
    - `createdDate` integer
    - `customAttributes` CustomAttribute[]
      - `attributeDefinitionId` string
      - `booleanValue` boolean
      - `dateValue` integer
      - `entityId` string
      - `entityReferences` EntityReference[]
        - `entityId` string
        - `entityName` string
      - `numberValue` string, number
      - `selectedValueId` string
      - `selectedValues` OnlyId[]
        - `id` string
      - `stringValue` string
    - `customerId` string
    - `fieldNumber` integer
    - `lastModifiedDate` integer
    - `levelNumber` integer
    - `name` string, required
    - `pickSequence` integer
    - `storagePlaceSizeId` string
    - `storagePlaceType` 'ASSEMBLY' | 'BLOCKED' | 'BUFFER' | 'CONSOLIDATION' | 'INBOUND' | 'PICKING' | 'STOCK' | 'UNIVERSAL' | 'UNIVERSAL_WITHOUT_PICKING', required

## Other responses

- `default`: error response

## Changes

- **2026-11-07** `0e021229755d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/weclapp/apis/weclapp-api/changes/shelf/post.md)

---

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