post https://a.klaviyo.com/api/catalog-items
Create a new catalog item.
Rate limits:
Burst: 75/s
Steady: 700/m
Scopes:
catalogs:write
Responses
Create a new catalog item.
Rate limits:
Burst: 75/s
Steady: 700/m
Scopes:
catalogs:write
xxxxxxxxxx
18curl --request POST \
--url https://a.klaviyo.com/api/catalog-items \
--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-item",
"attributes": {
"integration_type": "$custom",
"catalog_type": "$default",
"custom_metadata": {
"newKey": "New Value"
},
"published": true
},
"relationships": {
"categories": {
"data": [
{
"type": "catalog-category"
}
xxxxxxxxxx
41}
{
"data": {
"type": "catalog-item",
"id": "$custom:::$default:::SAMPLE-DATA-ITEM-1",
"attributes": {
"external_id": "SAMPLE-DATA-ITEM-1",
"title": "Ocean Blue Shirt (Sample)",
"description": "Ocean blue cotton shirt with a narrow collar and buttons down the front and long sleeves. Comfortable fit and titled kaleidoscope patterns.",
"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,
"created": "2022-11-08T00:00:00+00:00",
"updated": "2022-11-08T00:00:00+00:00"
},