Spawn Create Categories Job

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

Create a catalog category bulk create job to create a batch of catalog categories.

Accepts up to 100 catalog categories 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-category-bulk-create-job", "attributes"=>{"categories"=>{"data"=>[{"type"=>"catalog-category", "attributes"=>{"external_id"=>"<string>", "name"=>"<string>", "integration_type"=>"$custom", "catalog_type"=>"$default"}, "relationships"=>{"items"=>{"data"=>[{"type"=>"catalog-item", "id"=>"<string>"}, {"type"=>"catalog-item", "id"=>"<string>"}]}}}, {"type"=>"catalog-category", "attributes"=>{"external_id"=>"<string>", "name"=>"<string>", "integration_type"=>"$custom", "catalog_type"=>"$default"}, "relationships"=>{"items"=>{"data"=>[{"type"=>"catalog-item", "id"=>"<string>"}, {"type"=>"catalog-item", "id"=>"<string>"}]}}}]}}}}

HEADERS

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