Use this method to mass update products, groups, and tags within your product catalog.
Note: Only one Create/Update mass products call can be executed at a time. Please wait until one call is completed before sending another request to create or update a products. To get an update once each request is completed, make sure to specify a request_callback_url
or return_email address
.
Caution:
Only valid parameters will overwrite existing data. Excluding the
description
parameter or passing thedescription
parameter without a value will override and erase any existing description.
Note:
Only one Create/Update mass products call can be executed at a time. Please wait until one call is completed before sending another request to create or update a products. To get an update once each request is completed, make sure to specify a
request_callback_url
orreturn_email address
.
- Product group names support up to 100 characters
*Each individual call can accept a maximum of 300 products. Sending more than this number may result in a request timeout or failure.- SKUs cannot contain spaces.
Product Grouping
Use the Create mass products endpoint and this endpoint to create and update product groups, respectively.
You may define a callback URL to receive an asynchronous update once each request is complete and/or an email address to receive a report once your request is processed.
Product Tagging
Products can accept one tag per product and may not contain commas (,)
Adding more than one product tag per product will result in a failed request (400 Error)
As a result, no new products will be created.
Product Specs
- Universal Product Code
upc
: "upc-value", - Manufacturer Part Number
mpn
: "mpn-value", - Brand
brand
: "Yotpo", - International Standard Book Number
isbn
: "isbn-value" - Stock-keeping unit
sku
: "sku-value" - External stock-keeping unit
external_sku
: "external_sku value". This is a value you supply that represents a unique value within the domain.
Note:
For a list of ISO currency codes, go to http://www.currency-iso.org/en/home/tables/table-a1.html
Note:
- Trailing spaces are automatically stripped in the product specification.
- Any combination of leading zeros (“0”), leading spaces and leading dashes (“-“) are automatically stripped in the product specification.
- The product specification only supports alphanumeric (a...z, A...Z, 0...9), "_" and "-" characters.
- The product specification value is case-sensitive.
- The product specification value “N/A” is invalid in any case and is ignored.
If there is an error in the data that you submit, you receive an errors object in the response with the following information:
Parameter Name | Description |
---|---|
field | The field where the error occurred. |
error | Description of the error in the field. |