Add/update products

Creates and updates products in the catalog. Every item carries its own action: create for a new product, update for one already in the catalog. Items are validated independently, so an error in one item doesn't stop the others.
Required for create: productId, updatedDate, name, url, imageUrl, price, currency, isInStock, categories.
Required for update: productId, updatedDate and the fields that changed. A product already in the catalog is updated by create as well, but such a request still has to carry every field required for create.
One request takes up to 1,000 records and up to 10 MB, and one site takes up to 60 requests per minute. Don't send the same productId twice in one request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Products create/update request

string

Default language for top-level product fields

products
array of objects

Products to create or update

products
Responses

400

Request structure error, for example malformed JSON or a missing required top-level field.

413

Request too large. One request takes up to 1,000 records and up to 10 MB.

429

Too many requests:

  • More than 60 requests per minute per site.

502

Downstream service error. Retry the request later.

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json; charset=UTF-8