Create Item
POST/api/items/createitem
Tier: Public — stable, supported for third-party integration.
Creates a single tracked item against a SKU.
Item creation is serialised under a per-organisation lock. On success, a SystemEventType.ItemCreated notification is raised and the item's initial state is Present.
Request
Responses
- 200
- 400
- 401
- 403
Returns the created item, re-fetched after save. See Items.ItemDetailDto.
Validation failure, including: more than one entry in AddItemDto.ItemTagList (field
TagList); the SKU does not exist (field Sku); the SKU's
Enums.SkuLifecycleState is Draft or Discontinued
("SKU is in non-operational state (…); item creation not permitted."); the place is invalid (field
PlaceId); quantity/multiplier do not fit the SKU type's rules (field Multiplier); or the
requested tag is already attached to another item (TagNotAvailable, field Tag).
Caller is not authenticated.
Caller does not have Create permission on the Item module.