Skip to content

HighLevel: Products schemas

50 HighLevel schemas with complete fields and constraints.

← Products operations · All schemas

Action to include exclude the product in store — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
actionstringRequired within parentAction to include or exclude the product from the store
One of: include, exclude
altIdstringRequired within parentLocation Id or Agency Id
altTypestringRequired within parentOne of: location
productIdsarrayRequired within parentArray of product IDs
productIds[]stringEach item

Bulk Edit Products and Prices — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
altIdstringRequired within parentLocation Id or Agency Id
altTypestringRequired within parentOne of: location
productsarrayRequired within parentArray of products to update. Note: The total count includes all prices within each product.
products[]ModelEach itemExpand Bulk Edit Products and Prices — request body — body products item

Referenced models: Bulk Edit Products and Prices — request body — body products item

Bulk Edit Products and Prices — request body — body products item

FieldTypePresenceDescription and constraints
$objectRoot
_idstringRequired within parentProduct ID
automaticTaxCategoryIdstringOptionalAutomatic tax category ID
availableInStorebooleanOptionalProduct availability in store
collectionIdsarrayOptionalCollection IDs
collectionIds[]stringEach item
descriptionstringOptionalProduct description
imagestringOptionalProduct image
isLabelEnabledbooleanOptionalEnable product label
isTaxesEnabledbooleanOptionalEnable taxes
labelobjectOptionalProduct label
mediasarrayOptionalProduct media
medias[]objectEach item
namestringOptionalProduct name
pricesarrayOptionalArray of price variants for the product
prices[]ModelEach itemExpand Bulk Edit Products and Prices — request body — body products item prices item
seoJSONOptionalSEO metadata for the product
seo (allOf 1)ModelAll variants applyExpand Create Product — request body — body seo description, title
slugstringOptionalProduct URL slug
taxInclusivebooleanOptionalTax inclusive pricing
taxesarrayOptionalProduct taxes
taxes[]objectEach item

Referenced models: Bulk Edit Products and Prices — request body — body products item prices item, Create Product — request body — body seo description, title

Bulk Edit Products and Prices — request body — body products item prices item

FieldTypePresenceDescription and constraints
$objectRoot
_idstringRequired within parentPrice ID
allowOutOfStockPurchasesbooleanOptionalAllow out of stock purchases
amountnumberOptionalPrice amount
availableQuantitynumberOptionalAvailable quantity
compareAtPricenumberOptionalCompare at price
currencystringOptionalPrice currency
namestringOptionalPrice name
recurringJSONOptionalRecurring details
recurring (allOf 1)ModelAll variants applyExpand Create Price for a Product — request body — body / recurring / interval: day, month, week, year
setupFeenumberOptionalSetup fee
shippingOptionsJSONOptionalShipping options
shippingOptions (allOf 1)ModelAll variants applyExpand Create Price for a Product — request body — body shipping Options dimensions, weight
skustringOptionalSKU
totalCyclesnumberOptionalTotal billing cycles
trackInventorybooleanOptionalTrack inventory
trialPeriodnumberOptionalTrial period in days

Referenced models: Create Price for a Product — request body — body / recurring / interval: day, month, week, year, Create Price for a Product — request body — body shipping Options dimensions, weight

Bulk Edit Products and Prices — response body

FieldTypePresenceDescription and constraints
$objectRoot
messagestringRequired within parentSuccess message
statusbooleanRequired within parentOperation status
updatedCountJSONRequired within parent
updatedCount (anyOf 1)numberAlternativeNumber of products updated
updatedCount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Bulk Update Products — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
altIdstringRequired within parentLocation Id or Agency Id
altTypestringRequired within parentOne of: location
availabilitybooleanOptionalNew availability status
collectionIdsarrayOptionalArray of collection IDs
collectionIds[]stringEach item
compareAtPriceJSONOptionalCompare at price update configuration
compareAtPrice (allOf 1)ModelAll variants applyExpand Bulk Update Products — request body — body price round To Whole, type, value
currencystringOptionalCurrency code
filtersJSONOptionalFilters to apply when selectAll is true
filters (allOf 1)ModelAll variants applyExpand Bulk Update Products — request body — body filters available In Store, collection Ids, product Type, search
priceJSONOptionalPrice update configuration
price (allOf 1)ModelAll variants applyExpand Bulk Update Products — request body — body price round To Whole, type, value
productIdsarrayRequired within parentArray of product IDs
productIds[]stringEach item
typestringRequired within parentType of bulk update operation
One of: bulk-update-price, bulk-update-availability, bulk-update-product-collection, bulk-delete-products, bulk-update-currency

Referenced models: Bulk Update Products — request body — body filters available In Store, collection Ids, product Type, search, Bulk Update Products — request body — body price round To Whole, type, value

Bulk Update Products — request body — body filters available In Store, collection Ids, product Type, search

FieldTypePresenceDescription and constraints
$objectRoot
availableInStorebooleanOptionalFilter by availability status
collectionIdsarrayOptionalFilter by collection IDs
collectionIds[]stringEach item
productTypestringOptionalFilter by product type
searchstringOptionalFilter by search term

Bulk Update Products — request body — body price round To Whole, type, value

FieldTypePresenceDescription and constraints
$objectRoot
roundToWholebooleanOptionalRound to nearest whole number
typestringRequired within parentType of price update
One of: INCREASE_BY_AMOUNT, REDUCE_BY_AMOUNT, SET_NEW_PRICE, INCREASE_BY_PERCENTAGE, REDUCE_BY_PERCENTAGE
valuenumberRequired within parentValue to update (amount or percentage based on type)

Create Price for a Product — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
allowOutOfStockPurchasesbooleanOptionalContinue selling when out of stock
amountnumberRequired within parentThe amount of the price. ( min: 0 )
availableQuantitynumberOptionalAvailable inventory stock quantity
compareAtPricenumberOptionalThe compare at price for the price.
currencystringRequired within parentThe currency of the price.
descriptionstringOptionalA brief description of the price.
digitalDeliveryarrayOptionalDigital delivery options
digitalDelivery[]stringEach item
isDigitalProductbooleanOptionalIs the product a digital product
locationIdstringRequired within parentThe unique identifier of the location associated with the price.
membershipOffersarrayOptionalAn array of membership offers associated with the price.
membershipOffers[]ModelEach itemExpand Create Price for a Product — response body — membership Offers item
metaJSONOptionalAdditional metadata associated with the price.
meta (allOf 1)ModelAll variants applyExpand Create Price for a Product — request body — body / meta / internalSource: agency plan, funnel, membership, communities, gokollab, calendar, source: stripe, woocommerce, shopify
namestringRequired within parentThe name of the price.
recurringJSONOptionalThe recurring details of the price (if type is recurring).
recurring (allOf 1)ModelAll variants applyExpand Create Price for a Product — request body — body / recurring / interval: day, month, week, year
setupFeenumberOptionalThe setup fee for the price.
shippingOptionsJSONOptionalShipping options of the Price
shippingOptions (allOf 1)ModelAll variants applyExpand Create Price for a Product — request body — body shipping Options dimensions, weight
skustringOptionalThe unique identifier of the SKU associated with the price
totalCyclesnumberOptionalThe total number of billing cycles for the price. ( min: 1 )
trackInventorybooleanOptionalNeed to track inventory stock quantity
trialPeriodnumberOptionalThe trial period duration in days (if applicable).
typestringRequired within parentThe type of the price.
One of: one_time, recurring
userIdstringOptionalThe unique identifier of the user who created the price.
variantOptionIdsarrayOptionalAn array of variant option IDs associated with the price.
variantOptionIds[]stringEach item

Referenced models: Create Price for a Product — response body — membership Offers item, Create Price for a Product — request body — body / meta / internalSource: agency plan, funnel, membership, communities, gokollab, calendar, source: stripe, woocommerce, shopify, Create Price for a Product — request body — body / recurring / interval: day, month, week, year, Create Price for a Product — request body — body shipping Options dimensions, weight

Create Price for a Product — request body — body / meta / internalSource: agency plan, funnel, membership, communities, gokollab, calendar, source: stripe, woocommerce, shopify

FieldTypePresenceDescription and constraints
$objectRoot
internalSourcestringRequired within parentThe internal source of the price.
One of: agency_plan, funnel, membership, communities, gokollab, calendar
sourcestringRequired within parentThe source of the price.
One of: stripe, woocommerce, shopify
sourceIdstringOptionalThe id of the source of the price from where it is imported
stripePriceIdstringRequired within parentThe Stripe price ID associated with the price.

Create Price for a Product — request body — body / recurring / interval: day, month, week, year

FieldTypePresenceDescription and constraints
$objectRoot
intervalstringRequired within parentThe interval at which the recurring event occurs.
One of: day, month, week, year
intervalCountnumberRequired within parentThe number of intervals between each occurrence of the event.

Create Price for a Product — request body — body / shippingOptions / dimensions, weight / dimensions / unit: cm, in, m

FieldTypePresenceDescription and constraints
$objectRoot
heightnumberRequired within parentHeight of the price
lengthnumberRequired within parentLength of the price
unitstringRequired within parentUnit of the price dimensions
One of: cm, in, m
widthnumberRequired within parentWidth of the price

Create Price for a Product — request body — body / shippingOptions / dimensions, weight / weight / unit: kg, lb, g, oz

FieldTypePresenceDescription and constraints
$objectRoot
unitstringRequired within parentWeight unit of the product
One of: kg, lb, g, oz
valuenumberRequired within parentActual weight of the product

Create Price for a Product — request body — body shipping Options dimensions, weight

FieldTypePresenceDescription and constraints
$objectRoot
dimensionsJSONOptionalDimensions of the product
dimensions (allOf 1)ModelAll variants applyExpand Create Price for a Product — request body — body / shippingOptions / dimensions, weight / dimensions / unit: cm, in, m
weightJSONOptionalWeight options of the product
weight (allOf 1)ModelAll variants applyExpand Create Price for a Product — request body — body / shippingOptions / dimensions, weight / weight / unit: kg, lb, g, oz

Referenced models: Create Price for a Product — request body — body / shippingOptions / dimensions, weight / dimensions / unit: cm, in, m, Create Price for a Product — request body — body / shippingOptions / dimensions, weight / weight / unit: kg, lb, g, oz

Create Price for a Product — response body

FieldTypePresenceDescription and constraints
$objectRoot
_idstringRequired within parentThe unique identifier for the price.
allowOutOfStockPurchasesbooleanOptionalContinue selling when out of stock
amountJSONRequired within parent
amount (anyOf 1)numberAlternativeThe amount of the price.
amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
availableQuantityJSONOptional
availableQuantity (anyOf 1)numberAlternativeAvailable inventory stock quantity
availableQuantity (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
compareAtPriceJSONOptional
compareAtPrice (anyOf 1)numberAlternativeThe compare-at price for comparison purposes.
compareAtPrice (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
createdAtstringOptionalThe creation timestamp of the price.
Format: date-time
currencystringRequired within parentThe currency code for the price.
locationIdstringOptionalThe unique identifier for the location.
membershipOffersarrayOptionalAn array of membership offers associated with the price.
membershipOffers[]ModelEach itemExpand Create Price for a Product — response body — membership Offers item
namestringRequired within parentThe name of the price.
productstringOptionalThe unique identifier for the associated product.
recurringJSONOptionalThe recurring details of the price (if type is recurring).
recurring (allOf 1)ModelAll variants applyExpand Create Price for a Product — response body — recurring / interval: day, month, week, year
trackInventorybooleanOptionalIndicates whether inventory tracking is enabled.
typestringRequired within parentThe type of the price (e.g., one_time).
Known values: one_time, recurring
updatedAtstringOptionalThe last update timestamp of the price.
Format: date-time
userIdstringOptionalThe unique identifier for the user.
variantOptionIdsarrayOptionalAn array of variant option IDs associated with the price.
variantOptionIds[]stringEach item

Referenced models: Create Price for a Product — response body — membership Offers item, Create Price for a Product — response body — recurring / interval: day, month, week, year

Create Price for a Product — response body — membership Offers item

FieldTypePresenceDescription and constraints
$objectRoot
_idstringRequired within parentThe unique identifier for the membership offer.
labelstringRequired within parentMembership offer label
valuestringRequired within parentMembership offer label

Create Price for a Product — response body — recurring / interval: day, month, week, year

FieldTypePresenceDescription and constraints
$objectRoot
intervalstringRequired within parentThe interval at which the recurring event occurs.
Known values: day, month, week, year
intervalCountJSONRequired within parent
intervalCount (anyOf 1)numberAlternativeThe number of intervals between each occurrence of the event.
intervalCount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Create Product Collection — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
altIdstringRequired within parentLocation Id
altTypestringRequired within parentThe type of alt. For now it is only LOCATION
One of: location
collectionIdstringOptionalUnique Identifier of the Product Collection, Mongo Id
imagestringOptionalThe URL of the image that is going to be displayed as the collection Thumbnail
namestringRequired within parentName of the Product Collection
seoJSONOptionalThe metadata information which will be displayed in SEO previews
seo (allOf 1)ModelAll variants applyExpand Create Product Collection — request body — body seo description, title
slugstringRequired within parentSlug of the Product Collection which helps in navigation

Referenced models: Create Product Collection — request body — body seo description, title

Create Product Collection — request body — body seo description, title

FieldTypePresenceDescription and constraints
$objectRoot
descriptionstringOptionalThe description which would be displayed in preview purposes
titlestringOptionalThe title which will be displayed as an SEO format

Create Product Collection — response body

FieldTypePresenceDescription and constraints
$objectRoot
dataJSONRequired within parentcreated Collection
data (allOf 1)ModelAll variants applyExpand Create Product Collection — response body — data id, alt Id, created At, image, name, seo, slug

Referenced models: Create Product Collection — response body — data id, alt Id, created At, image, name, seo, slug

Create Product Collection — response body — data id, alt Id, created At, image, name, seo, slug

FieldTypePresenceDescription and constraints
$objectRoot
_idstringRequired within parentThe unique identifier for the collection
altIdstringRequired within parentLocation Id to which the collection is associated
createdAtstringRequired within parentDate at which the collection was created
imagestringRequired within parentThe URL of the image that is going to be displayed as the collection Thumbnail
namestringRequired within parentName of the collection
seoJSONRequired within parentThe information which will be displayed in SEO previews
seo (allOf 1)ModelAll variants applyExpand Create Product Collection — request body — body seo description, title
slugstringRequired within parentSlug of the collection with which navigation is established. Special Characters and spacing is not allowed and should be unique

Referenced models: Create Product Collection — request body — body seo description, title

Create Product — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
automaticTaxCategoryIdstringOptionalTax category ID for Automatic taxes calculation.
availableInStorebooleanOptionalIndicates whether the product is available in-store.
collectionIdsarrayOptionalAn array of category Ids for the product
collectionIds[]stringEach item
descriptionstringOptionalA brief description of the product.
imagestringOptionalThe URL for the product image.
isLabelEnabledbooleanOptionalIs the product label enabled. If this is true, label object cannot be empty.
Default: false
isTaxesEnabledbooleanOptionalAre there any taxes attached to the product. If this is true, taxes array cannot be empty.
Default: false
labelJSONOptionalDetails for Product Label
label (allOf 1)ModelAll variants applyExpand Create Product — response body — label end Date, start Date, title
locationIdstringRequired within parentThe unique identifier for the location.
mediasarrayOptionalAn array of medias for the product.
medias[]ModelEach itemExpand Create Product — request body — body medias item
namestringRequired within parentThe name of the product.
productTypestringRequired within parentOne of: DIGITAL, PHYSICAL, SERVICE, PHYSICAL/DIGITAL
seoJSONOptionalSEO data for the product that will be displayed in the preview
seo (allOf 1)ModelAll variants applyExpand Create Product — request body — body seo description, title
slugstringOptionalThe slug using which the product navigation will be handled
statementDescriptorstringOptionalThe statement descriptor for the product.
taxInclusivebooleanOptionalWhether the taxes should be included in the purchase price
Default: false
taxesarrayOptionalList of ids of Taxes attached to the Product. If taxes are passed, isTaxesEnabled should be true.
taxes[]stringEach item
variantsarrayOptionalAn array of variants for the product.
variants[]ModelEach itemExpand Create Product — response body — variants item

Referenced models: Create Product — response body — label end Date, start Date, title, Create Product — response body — variants item, Create Product — request body — body medias item, Create Product — request body — body seo description, title

Create Product — request body — body medias item

FieldTypePresenceDescription and constraints
$objectRoot
idstringRequired within parentThe unique identifier for the media.
isFeaturedbooleanOptionalIndicates whether the media is featured.
priceIdsarrayOptionalMongo ObjectIds of the prices for which the media is assigned
priceIds[]arrayEach item
titlestringOptionalThe title of the media file.
typestringRequired within parentThe type of the media file (e.g., image, video will be supporting soon).
One of: image, video
urlstringRequired within parentThe URL where the media file is stored.

Create Product — request body — body seo description, title

FieldTypePresenceDescription and constraints
$objectRoot
descriptionstringOptionalSEO description
titlestringOptionalSEO title

Create Product — response body

FieldTypePresenceDescription and constraints
$objectRoot
_idstringRequired within parentThe unique identifier for the product.
automaticTaxCategoryIdstringOptionalTax category ID for Automatic taxes calculation.
availableInStorebooleanOptionalIndicates whether the product is available in-store.
collectionIdsarrayOptionalAn array of category Ids for the product
collectionIds[]stringEach item
createdAtstringRequired within parentThe creation timestamp of the product.
Format: date-time
descriptionstringOptionalproduct description
imagestringOptionalThe URL for the product image.
isTaxesEnabledbooleanOptionalThe field indicates whether taxes are enabled for the product or not.
Default: false
labelJSONOptionalThe Product label details
label (allOf 1)ModelAll variants applyExpand Create Product — response body — label end Date, start Date, title
locationIdstringRequired within parentThe unique identifier for the location.
namestringRequired within parentThe name of the product.
productTypestringRequired within parentThe type of the product (e.g., PHYSICAL).
slugstringOptionalThe slug of the product by which the product will be navigated
statementDescriptorstringOptionalThe statement descriptor for the product.
taxesarrayOptionalAn array of ids of Taxes attached to the Product. If the expand query includes tax, the taxes will be of type `ProductTaxDto`. Please refer to the `ProductTaxDto` for additional details.
taxes[]stringEach item
updatedAtstringRequired within parentThe last update timestamp of the product.
Format: date-time
variantsarrayOptionalAn array of variants for the product.
variants[]ModelEach itemExpand Create Product — response body — variants item

Referenced models: Create Product — response body — label end Date, start Date, title, Create Product — response body — variants item

Create Product — response body — label end Date, start Date, title

FieldTypePresenceDescription and constraints
$objectRoot
endDatestringOptionalStart date in YYYY-MM-DDTHH:mm:ssZ format
startDatestringOptionalStart date in YYYY-MM-DDTHH:mm:ssZ format
titlestringRequired within parentThe content for the product label.

Create Product — response body — variants item

FieldTypePresenceDescription and constraints
$objectRoot
idstringRequired within parentA unique identifier for the variant.
namestringRequired within parentThe name of the variant.
optionsarrayRequired within parentAn array of options for the variant.
options[]ModelEach itemExpand Create Product — response body — variants item options item

Referenced models: Create Product — response body — variants item options item

Create Product — response body — variants item options item

FieldTypePresenceDescription and constraints
$objectRoot
idstringRequired within parentThe unique identifier for the option.
namestringRequired within parentThe name of the option.

Delete Price by ID for a Product — response body

FieldTypePresenceDescription and constraints
$objectRoot
statusbooleanRequired within parentreturns true if the price is successfully deleted

Delete Product by ID — response body

FieldTypePresenceDescription and constraints
$objectRoot
statusbooleanRequired within parentreturns true if the product is successfully deleted

Fetch Product Reviews — response body

FieldTypePresenceDescription and constraints
$objectRoot
dataarrayRequired within parentArray of Collections
data[]arrayEach item
totalJSONRequired within parent
total (anyOf 1)numberAlternativeThe total count of the collections present, which is useful to calculate the pagination
total (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Fetch Product Store Stats — response body

FieldTypePresenceDescription and constraints
$objectRoot
excludedFromStoreJSONRequired within parent
excludedFromStore (anyOf 1)numberAlternativeNumber of products excluded from the store
excludedFromStore (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
includedInStoreJSONRequired within parent
includedInStore (anyOf 1)numberAlternativeNumber of products included in the store
includedInStore (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
totalProductsJSONRequired within parent
totalProducts (anyOf 1)numberAlternativeTotal number of products
totalProducts (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Fetch Review Count as per status — response body

FieldTypePresenceDescription and constraints
$objectRoot
dataarrayRequired within parentArray of review status counts
data[]arrayEach item

Get Details about individual product collection — response body

FieldTypePresenceDescription and constraints
$objectRoot
dataJSONRequired within parentCollection Data
data (allOf 1)ModelAll variants applyExpand Delete Event — request body — body
statusbooleanRequired within parentStatus of the operation

Referenced models: Delete Event — request body — body

List Inventory — response body

FieldTypePresenceDescription and constraints
$objectRoot
inventoryarrayRequired within parentList of inventory items
inventory[]ModelEach itemExpand List Inventory — response body — inventory item
totalobjectRequired within parentTotal count of inventory items

Referenced models: List Inventory — response body — inventory item

List Inventory — response body — inventory item

FieldTypePresenceDescription and constraints
$objectRoot
_idstringRequired within parentThe unique identifier for the price
allowOutOfStockPurchasesbooleanRequired within parentWhether out of stock purchases are allowed
availableQuantityJSONRequired within parent
availableQuantity (anyOf 1)numberAlternativeAvailable quantity in inventory
availableQuantity (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
imagestringOptionalProduct image URL
namestringRequired within parentName of the price/variant
productstringRequired within parentProduct ID this price belongs to
productNamestringOptionalProduct name
skustringRequired within parentSKU for the product variant
updatedAtstringRequired within parentLast update timestamp

List Prices for a Product — response body

FieldTypePresenceDescription and constraints
$objectRoot
pricesarrayRequired within parentAn array of prices
prices[]ModelEach itemExpand Create Price for a Product — response body
totalJSONRequired within parent
total (anyOf 1)numberAlternativeDefault: Total number of prices available
total (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: Create Price for a Product — response body

List Products — response body

FieldTypePresenceDescription and constraints
$objectRoot
productsarrayRequired within parentAn array of products
products[]ModelEach itemExpand Create Product — response body
totalarrayRequired within parentlist products status
total[]ModelEach itemExpand List Products — response body — total item

Referenced models: Create Product — response body, List Products — response body — total item

List Products — response body — total item

FieldTypePresenceDescription and constraints
$objectRoot
totalJSONRequired within parent
total (anyOf 1)numberAlternativeTotal number of products
total (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Update Inventory — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
altIdstringRequired within parentLocation Id or Agency Id
altTypestringRequired within parentOne of: location
itemsarrayRequired within parentArray of items to update in the inventory.
items[]ModelEach itemExpand Update Inventory — request body — body items item

Referenced models: Update Inventory — request body — body items item

Update Inventory — request body — body items item

FieldTypePresenceDescription and constraints
$objectRoot
allowOutOfStockPurchasesbooleanOptionalWhether to continue selling the item when out of stock.
availableQuantitynumberOptionalThe available quantity of the item.
priceIdstringRequired within parentThe unique identifier for the price, in MongoDB ID format.

Update Inventory — response body

FieldTypePresenceDescription and constraints
$objectRoot
messagestringOptionalSuccess message
statusbooleanRequired within parentStatus of api action

Update Product Collection — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
altIdstringRequired within parentLocation Id
altTypestringRequired within parentThe type of alt. For now it is only LOCATION
One of: location
imagestringOptionalThe URL of the image that is going to be displayed as the collection Thumbnail
namestringOptionalName of the Product Collection
seoJSONOptionalThe metadata information which will be displayed in SEO previews
seo (allOf 1)ModelAll variants applyExpand Create Product Collection — request body — body seo description, title
slugstringOptionalSlug of the Product Collection which helps in navigation

Referenced models: Create Product Collection — request body — body seo description, title

Update Product Reviews — products bulk Update Product Review — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
altIdstringRequired within parentLocation Id or Agency Id
altTypestringRequired within parentOne of: location
reviewsarrayRequired within parentArray of Product Reviews
reviews[]ModelEach itemExpand Update Product Reviews — products bulk Update Product Review — request body — body reviews item
statusobjectRequired within parentStatus of the review

Referenced models: Update Product Reviews — products bulk Update Product Review — request body — body reviews item

Update Product Reviews — products bulk Update Product Review — request body — body reviews item

FieldTypePresenceDescription and constraints
$objectRoot
productIdstringRequired within parentProduct Id
reviewIdstringRequired within parentReview Id
storeIdstringRequired within parentStore Id

Update Product Reviews — products update Product Review — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
altIdstringRequired within parentLocation Id or Agency Id
altTypestringRequired within parentOne of: location
detailstringOptionalDetailed Review of the product
headlinestringOptionalHeadline of the Review
productIdstringRequired within parentProduct Id
ratingnumberOptionalRating of the product
replyarrayOptionalReply of the review
reply[]ModelEach itemExpand Update Product Reviews — products update Product Review — request body — body reply item
statusstringRequired within parentStatus of the review

Referenced models: Update Product Reviews — products update Product Review — request body — body reply item

Update Product Reviews — products update Product Review — request body — body reply item

FieldTypePresenceDescription and constraints
$objectRoot
commentstringRequired within parentDetailed Review of the product
Maximum length: 5000
Minimum length: 0
headlinestringRequired within parentHeadline of the Review
Maximum length: 200
Minimum length: 0
userJSONRequired within parentUser who is giving the review/reply
user (allOf 1)ModelAll variants applyExpand Update Product Reviews — products update Product Review — request body — body reply item user email, is Customer, name, phone

Referenced models: Update Product Reviews — products update Product Review — request body — body reply item user email, is Customer, name, phone

Update Product Reviews — products update Product Review — request body — body reply item user email, is Customer, name, phone

FieldTypePresenceDescription and constraints
$objectRoot
emailstringRequired within parentEmail of the customer
isCustomerbooleanOptionalIs the person an admin or customer
namestringRequired within parentName of the customer
Maximum length: 100
Minimum length: 1
phonestringOptionalPhone no of the customer

Update Product by ID — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
automaticTaxCategoryIdstringOptionalTax category ID for Automatic taxes calculation.
availableInStorebooleanOptionalIndicates whether the product is available in-store.
collectionIdsarrayOptionalAn array of category Ids for the product
collectionIds[]stringEach item
descriptionstringOptionalA brief description of the product.
imagestringOptionalThe URL for the product image.
isLabelEnabledbooleanOptionalIs the product label enabled. If this is true, label object cannot be empty.
Default: false
isTaxesEnabledbooleanOptionalAre there any taxes attached to the product. If this is true, taxes array cannot be empty.
Default: false
labelJSONOptionalDetails for Product Label
label (allOf 1)ModelAll variants applyExpand Create Product — response body — label end Date, start Date, title
locationIdstringRequired within parentThe unique identifier for the location.
mediasarrayOptionalAn array of medias for the product.
medias[]ModelEach itemExpand Create Product — request body — body medias item
namestringRequired within parentThe name of the product.
pricesarrayOptionalThe prices of the product
prices[]stringEach item
productTypestringRequired within parentOne of: DIGITAL, PHYSICAL, SERVICE, PHYSICAL/DIGITAL
seoJSONOptionalSEO data for the product that will be displayed in the preview
seo (allOf 1)ModelAll variants applyExpand Create Product — request body — body seo description, title
slugstringOptionalThe slug using which the product navigation will be handled
statementDescriptorstringOptionalThe statement descriptor for the product.
taxInclusivebooleanOptionalWhether the taxes should be included in the purchase price
Default: false
taxesarrayOptionalList of ids of Taxes attached to the Product. If taxes are passed, isTaxesEnabled should be true.
taxes[]stringEach item
variantsarrayOptionalAn array of variants for the product.
variants[]ModelEach itemExpand Create Product — response body — variants item

Referenced models: Create Product — response body — label end Date, start Date, title, Create Product — response body — variants item, Create Product — request body — body medias item, Create Product — request body — body seo description, title

Update product display priorities in store — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
altIdstringRequired within parentLocation Id or Agency Id
altTypestringRequired within parentOne of: location
productsarrayRequired within parentArray of products with their display priorities
products[]arrayEach item

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.