Create Catalog Variant

POST {{baseUrl}}/api/catalog-variants/

Create a new variant for a related catalog item.

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

Scopes: catalogs:write

Request Body

{"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>"}}}}}

HEADERS

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

RESPONSES

status: Created

{&quot;data&quot;:{&quot;type&quot;:&quot;catalog-variant&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;attributes&quot;:{&quot;external_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;sku&quot;:&quot;\u003cstring\u003e&quot;,&quot;inventory_policy&quot;:0,&quot;inventory_quantity&quot;:&quot;\u003cnumber\u003e&quot;,&quot;price&quot;:&quot;\u003cnumber\u003e&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;image_full_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;image_thumbnail_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;images&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;custom_metadata&quot;:{},&quot;published&quot;:&quot;\u003cboolean\u003e&quot;,&quot;created&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;updated&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;},&quot;relationships&quot;:{&quot;item&quot;:{&quot;data&quot;:{&quot;type&quot;:&quot;catalog-item&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;},&quot;links&quot;:{&quot;self&quot;:&quot;\u003curi\u003e&quot;,&quot;related&quot;:&quot;\u003curi\u003e&quot;}}}}}