---
title: "Create a stock item"
method: POST
path: "/v1/stockItems"
tags: ["Stock"]
---

# Create a stock item

`POST /v1/stockItems`

Creates a new stock item entity (required scope stock:write)

## Headers

- `Customer-Id` integer, required

## Request body

- CreateStockItemsModel — Represents a model for creating stock items
  - `stockDetailsId` integer, required — The unique identifier of the stock details related to this stock item
  - `quantity` number, double, nullable — The quantity of the stock items. Must be omitted or null if the stock item is not consumable
  - `locationContactId` integer, nullable — The ID of the contact associated with the stock item, must be omitted or null if the stock item is located at a vehicle or another stock item
  - `locationVehicleId` integer, nullable — The ID of the vehicle associated with the stock item, must be omitted or null if the stock item is located at a contact or another stock item
  - `locationStockItemId` integer, nullable — The ID of the stock item this stock item is allocated to, must be omitted or null if the stock item is located at a contact or a vehicle
  - `soldAt` string, date-time, nullable — The date when the stock item was sold
  - `notes` string, nullable — Notes on the stock item, must be null or omitted if the stock item is not consumable
  - `serialNumber` string, nullable — The unique number or barcode assigned to each individual stock item for identification and tracking. Required if the stock item is non consumable, otherwise must be null or omitted. Cannot contain preceding or trailing whitespace
  - `altSerialNumber` string, nullable — The alternative serial number of the stock item. Must be omitted or null if the stock item is consumable
  - `supplierSerialNumber` string, nullable — The unique number used by the supplier for the stock item, must be null or omitted if the stock item is not consumable
  - `customerSerialNumber` string, nullable — The number assigned by the customer for the stock item
  - `isEquipment` boolean — Indicates whether the stock item is equipment or not, defaults to false
  - `condition` 'new' | 'refurbished' | 'used' — Represents the condition of a stock item<p>Possible values:</p><ul><li><b>new</b>: New stock item</li><li><b>refurbished</b>: Refurbished stock item</li><li><b>used</b>: Used stock item</li></ul>
  - `usage` number, double, nullable — The usage of the stock item, must be null or omitted when stock item is consumable
  - `customFields` CustomFieldWriteModel[], nullable — The custom fields associated with the stock item
    - `definitionId` integer, required — The unique identifier of the associated custom field definition
    - `value` string, nullable — The value of this custom field. If set to null, any existing value will be unset

## Response `201`

Created

- PostResponseInt64 — Represents a response for a POST request, containing the ID of the newly created record
  - `id` integer — Identifier of the newly created record

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/bigchange/apis/bigchange-dx.md) · [All operations](https://skmtc.net/bigchange/apis/bigchange-dx/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigchange/bigchange-dx/revisions/916e669fc527/schema)