Spawn Create Items Job

POST {{baseUrl}}/api/catalog-item-bulk-create-jobs/

Create a catalog item bulk create job to create a batch of catalog items. Accepts up to 100 catalog items per request. The maximum allowed payload size is 4MB.

Rate limits:
Burst: 75/s
Steady: 700/m

Scopes: catalogs:write

Request Body

{"data"=>{"type"=>"catalog-item-bulk-create-job", "attributes"=>{"items"=>[{"type"=>"catalog-item", "attributes"=>{"external_id"=>"<string>", "title"=>"<string>", "description"=>"<string>", "url"=>"<string>", "integration_type"=>"$custom", "price"=>"<number>", "catalog_type"=>"$default", "image_full_url"=>"<string>", "image_thumbnail_url"=>"<string>", "images"=>["<string>", "<string>"], "published"=>true}, "relationships"=>{"categories"=>{"data"=>[{"type"=>"catalog-category", "id"=>"<string>"}, {"type"=>"catalog-category", "id"=>"<string>"}]}}}, {"type"=>"catalog-item", "attributes"=>{"external_id"=>"<string>", "title"=>"<string>", "description"=>"<string>", "url"=>"<string>", "integration_type"=>"$custom", "price"=>"<number>", "catalog_type"=>"$default", "image_full_url"=>"<string>", "image_thumbnail_url"=>"<string>", "images"=>["<string>", "<string>"], "published"=>true}, "relationships"=>{"categories"=>{"data"=>[{"type"=>"catalog-category", "id"=>"<string>"}, {"type"=>"catalog-category", "id"=>"<string>"}]}}}]}}}

HEADERS

KeyDatatypeRequiredDescription
revisionstring(Required) API endpoint revision (format: YYYY-MM-DD[.suffix])
Content-Typestring
Acceptstring