post https://a.klaviyo.com/api/catalog-variants
Create a new variant for a related catalog item.
Rate limits:
Burst: 75/s
Steady: 700/m
Scopes:
catalogs:write
Responses
Create a new variant for a related catalog item.
Rate limits:
Burst: 75/s
Steady: 700/m
Scopes:
catalogs:write
xxxxxxxxxx
26curl --request POST \
--url https://a.klaviyo.com/api/catalog-variants \
--header 'Authorization: Klaviyo-API-Key your-private-api-key' \
--header 'accept: application/vnd.api+json' \
--header 'content-type: application/vnd.api+json' \
--header 'revision: 2025-01-15' \
--data '
{
"data": {
"type": "catalog-variant",
"attributes": {
"catalog_type": "$default",
"integration_type": "$custom",
"inventory_policy": 0,
"custom_metadata": {
"newKey": "New Value"
},
"published": true
},
"relationships": {
"item": {
"data": {
"type": "catalog-item"
}
xxxxxxxxxx
42}
{
"data": {
"type": "catalog-variant",
"id": "$custom:::$default:::SAMPLE-DATA-ITEM-1-VARIANT-MEDIUM",
"attributes": {
"external_id": "SAMPLE-DATA-ITEM-1-VARIANT-MEDIUM",
"title": "Ocean Blue Shirt (Sample) Variant Medium",
"description": "Ocean blue cotton shirt with a narrow collar and buttons down the front and long sleeves. Comfortable fit and titled kaleidoscope patterns.",
"sku": "OBS-MD",
"inventory_policy": 2,
"inventory_quantity": 25,
"price": 42,
"url": "https://via.placeholder.com/150",
"image_full_url": "https://via.placeholder.com/300",
"image_thumbnail_url": "https://via.placeholder.com/150",
"images": [
"https://via.placeholder.com/150"
],
"custom_metadata": {
"Top Pick": true
},
"published": true,