Update Catalog Item

patch https://a.klaviyo.com/api/catalog-items/{id}

Update a catalog item with the given item ID.

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

Scopes:
catalogs:write

Responses

Language

Credentials

Header


xxxxxxxxxx
13
1
curl --request PATCH \
2
     --url https://a.klaviyo.com/api/catalog-items/id \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/vnd.api+json' \
5
     --header 'content-type: application/vnd.api+json' \
6
     --header 'revision: 2025-04-15' \
7
     --data '
8
{
9
  "data": {
10
    "type": "catalog-item"
11
  }
12
}
13
'


xxxxxxxxxx
41
}
1
{
2
  "data": {
3
    "type": "catalog-item",
4
    "id": "$custom:::$default:::SAMPLE-DATA-ITEM-1",
5
    "attributes": {
6
      "external_id": "SAMPLE-DATA-ITEM-1",
7
      "title": "Ocean Blue Shirt (Sample)",
8
      "description": "Ocean blue cotton shirt with a narrow collar and buttons down the front and long sleeves. Comfortable fit and titled kaleidoscope patterns.",
9
      "price": 42,
10
      "url": "https://via.placeholder.com/150",
11
      "image_full_url": "https://via.placeholder.com/300",
12
      "image_thumbnail_url": "https://via.placeholder.com/150",
13
      "images": [
14
        "https://via.placeholder.com/150"
15
      ],
16
      "custom_metadata": {
17
        "Top Pick": true
18
      },
19
      "published": true,
20
      "created": "2022-11-08T00:00:00+00:00",
21
      "updated": "2022-11-08T00:00:00+00:00"
22
    },
23
    "relationships": {
24
      "variants": {
25
        "data": [

200Success

4XXClient Error

5XXServer Error