Spawn Create Variants Job

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

Create a catalog variant bulk create job to create a batch of catalog variants.

Accepts up to 100 catalog variants per request. The maximum allowed payload size is 5MB.

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

Scopes: catalogs:write

Request Body

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

HEADERS

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