Create or Update Item

Creates or updates an item in Loyverse.

PUT

Query

Field selectionChoose which fields should be included in the response. Learn more

string

Comma-separated response fields to include.

Body

Arguments

string

Read-only internal id of the item. If included in the POST request it will cause an update instead of a creating a new object.

string

stringrequired

The item name.

string

The item description.

string

External reference id for the item

string

The category id of the item

boolean

If true, the system tracks inventory for this item at all stores. Make sure you don't accidentally disable track stock. If you set `track_stock` to false then all inventory levels of this item are set to 0

boolean

If true, a fractional quantity for this item can be specified at the time of a sale (for example 1.5)

boolean

If true, the item contains a specified quantity of other items. [Learn more](https://help.loyverse.com/help/how-create-composite-item)

boolean

If true, the system tracks stock not only for its components but also for this item. This property can be set only for composite items. [Learn more](https://help.loyverse.com/help/how-work-production)

array of object

The list of components for the item. [Learn more](https://help.loyverse.com/help/how-create-composite-item)

string

array of string

The list of tax ids applied to this item

array of string

The list of modifiers ids applied to this item

string

The visual form of the item that is displayed on the POS

string

One of the predefined colors for the item that is displayed on the POS

string

The name of the first option (for example "Size"). [Learn more](https://help.loyverse.com/help/how-use-variants-items)

string

The name of the first option (for example "Color"). [Learn more](https://help.loyverse.com/help/how-use-variants-items)

string

The name of the first option (for example "Material"). [Learn more](https://help.loyverse.com/help/how-use-variants-items)

date

The time when this resource was created (ISO 8601 format, e.g. 2020-03-25T19:55:23.077Z)

date

The time when this resource was updated (ISO 8601 format, e.g. 2020-03-30T08:05:10.020Z)

date

The time when this resource was deleted (ISO 8601 format, e.g. 2020-04-02T23:45:20.050Z)

array of object

curl --request PUT \ --url "https://connect.mindcloud.co/v1/universal/loyverse/0.0.7/actions/create-or-update-item" \ --header "Authorization: Bearer $MINDCLOUD_API_TOKEN" \ --header "Content-Type: application/json" \ --data '{ "connectionId": "$CONNECTION_ID", "itemName": "" }'

{ "success": true, "data": [ { "categoryId": "string", "color": "string", "components": [ {} ], "components[]": { "quantity": 1, "variantId": "string" }, "createdAt": "2026-05-07T12:00:00.000Z", "deletedAt": "2026-05-07T12:00:00.000Z", "description": "string", "form": "string", "handle": "string", "id": "string", "imageUrl": "https://example.com", "isComposite": true, "itemName": "string", "modifiersIds": [ "string" ], "option1Name": "string", "option2Name": "string", "option3Name": "string", "primarySupplierId": "string", "referenceId": "string", "soldByWeight": true, "taxIds": [ "string" ], "trackStock": true, "updatedAt": "2026-05-07T12:00:00.000Z", "useProduction": true, "variants": [ {} ], "variants[]": { "barcode": "string", "cost": 1, "createdAt": "2026-05-07T12:00:00.000Z", "defaultPrice": 1, "defaultPricingType": "string", "deletedAt": "2026-05-07T12:00:00.000Z", "itemId": "string", "option1Value": "string", "option2Value": "string", "option3Value": "string", "purchaseCost": 1, "referenceVariantId": "string", "sku": "string", "stores": [ {} ], "stores[]": { "availableForSale": true, "lowStock": 1, "optimalStock": 1, "price": 1, "pricingType": "string", "storeId": "string" }, "updatedAt": "2026-05-07T12:00:00.000Z", "variantId": "string" } } ], "meta": {} }

Query

Body

Every app you connect,one REST pattern