Create item
Create a new item in a product.
The item will be created with the provided name and readable_id.
If parent_item_id is provided, the item will be created as a child of that item.
Optional part_number is validated when the product has format configuration in the app.
Part numbers
- 409: duplicate
part_numberwithin the organization (response includes conflicting entity details). - 422: value does not match the product’s configured format.
Authorizations
Enter your API key. Example: Bearer poelis_api_...
Body
Request to create a new item.
Product ID to create the item in
Item name
1Human-readable item ID (must be unique within parent scope). Only lowercase letters, numbers and underscores are allowed.
1^[a-z0-9_]+$Item description
Optional part number to assign on create. Must be unique within the organization.
Parent item ID for hierarchical structure
Response
Created item
Public representation of an item.
Human-readable item ID
Product this item belongs to
Item name
Whether the item is deleted
Parent item ID for hierarchical structure
Item description
Active item part number, when assigned. Uniqueness is enforced organization-wide; format is validated when the product has rule configuration in the app.
Draft item ID if this is a versioned item
User who created the item
ISO 8601 creation timestamp
ISO 8601 last-update timestamp
User who last updated the item