Create mass products

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.

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

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 or return_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 NameDescription
fieldThe field where the error occurred.
errorDescription of the error in the field.
Body Params
string
required

Your Yotpo account access token. See Yotpo Authentication to learn how to generate your utoken.

string

Include an email address to receive a status report once your request is processed.

string

Include a callback URL to receive an asynchronous update once your request is processed.

products
object

Object containing products metadata

product_id
object
Responses

Language
LoadingLoading…
Response
Choose an example:
application/json