Use this method to mass create new 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 result_callback_url
or return_email_address
.
Important:
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
result_callback_url
orreturn_email_address
.
- Product group is limited to 100 lowercase alphanumeric characters (a...z, 0...9) and the "_" and
"-" symbols, without spaces.- 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 this endpoint and the Update mass products 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 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
: "ski value" - European Article Number
ean
: "ean value" - External stock-keeping unit
external_sku
: "external_sku value". This is a value you supply that represents a unique value within the domain.
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.
Note:
For a list of ISO currency codes, click here
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.
- SKU only supports alphanumeric (a...z, A...Z, 0...9), "_" and "-" characters and cannot contain spaces.
- 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. |