---
title: "Create a new item"
method: POST
path: "/api/items"
tags: ["Item"]
---

# Create a new item

`POST /api/items`

## Request body

- ItemCreateDto — Details of item to be created
  - `number` string, required — The name to give the item. Must be unique to all active items.
  - `description` string — The verbose description to give the item.
  - `revision` string, nullable — Revision name
  - `itemOrigin` 'make' | 'buy' | 'makeOrBuy' | 'customerSupplied' | 'kit' | 'none', required
  - `unitTypeName` string, required — The unit of measure type, ex: Pieces, Volume, Weight, Area
  - `unitOfMeasureName` string, required — The unit of measure name. Options available depend on the selected UnitTypeName. For Pieces, you might have a UOM of Piece, Set or Case. For Volume options include Liter, Milliliter, etc.
  - `isSellable` boolean, nullable — Define if this item is able to be sold/sellable.
  - `isSingleUseItem` boolean, nullable — Indicate if this item is intended for single use.
  - `isLotTracked` boolean, nullable — Indicate if this item is going to be lot-tracked.
  - `accountingCodeId` string, nullable — Accounting code key identifier. Please reference /api/accounting-codes endpoint.
  - `accountingCode2Id` string, nullable — Accounting code key identifier. Please reference /api/accounting-codes endpoint.
  - `materialCodeId` string, nullable — Item material code key identifier. Please reference /api/material-codes endpoint.
  - `categoryId` string, nullable — Item category code key identifier. Please reference /api/item-categories endpoint.
  - `gradeId` string, nullable — Item grade code key identifier. Please reference /api/grade-codes endpoint.
  - `shapeId` string, nullable — Item shape code key identifier. Please reference /api/shape-codes endpoint.
  - `gaugeId` string, nullable — Item gauge code key identifier. Please reference /api/gauge-codes endpoint.
  - `width` number, double, nullable — Item width
  - `height` number, double, nullable — Item height
  - `length` number, double, nullable — Item length
  - `weight` number, double, nullable — Item weight
  - `minimumStockOnHand` number, double, nullable — Item minimum stock on hand.
  - `minimumProductionQuantity` number, double, nullable — Item minimum production quantity for a manufacturing run.
  - `internalNotes` string, nullable — Internal item notes.
  - `salesUnitOfMeasureConversions` CommonUnitOfMeasureConversionDto[], nullable — Unit of measure conversions for sellable items.
    - `sourceQuantity` number, double, required — This value signifies the quantity of the item's source unit of measure.
    - `destinationQuantity` number, double, required — This value signifies the quantity of the "destination" unit of measure.
    - `destinationUnitOfMeasureName` string, required — The destination unit of measure.
    - `isCustom` boolean — Indicate if this is a custom (not out-of-the-box) unit of measure.
    - `isDefault` boolean — Indicate if this is the default unit of measure
    - `multiplier` number, double — Indicates the conversion factor used to calculate source to converted units.
  - `isTaxable` boolean, nullable — Whether or not this item is taxable (default)
  - `buildToOrder` boolean, nullable — Whether or not this item is build to order (jobs are made from sales orders, not overall demand)
  - `buildToStock` boolean, nullable — Whether or not this item is build to stock (jobs are created from overall demand, not sales orders)
  - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for this line item.

## Response `200`

Item created

- CreatedResponseDto — Response for a created record
  - `id` string, required — The id of the created record

## Other responses

- `400` — Validation issues with input

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)