Create Catalog Category

post https://a.klaviyo.com/api/catalog-categories/

Create a new catalog category.

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

Scopes:
catalogs:write

Responses

Language

Credentials

Header


xxxxxxxxxx
18
1
curl --request POST \
2
     --url https://a.klaviyo.com/api/catalog-categories/ \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json' \
6
     --header 'revision: 2023-06-15' \
7
     --data '
8
{
9
  "data": {
10
    "type": "catalog-category",
11
    "attributes": {
12
      "external_id": "SAMPLE-DATA-CATEGORY-APPAREL",
13
      "name": "Sample Data Category Apparel",
14
      "catalog_type": "$default"
15
    }
16
  }
17
}
18
'


xxxxxxxxxx
28
}
1
{
2
  "data": {
3
    "type": "catalog-category",
4
    "id": "$custom:::$default:::SAMPLE-DATA-CATEGORY-APPAREL",
5
    "attributes": {
6
      "external_id": "SAMPLE-DATA-CATEGORY-APPAREL",
7
      "name": "Sample Data Category Apparel",
8
      "updated": "2022-11-08T00:00:00"
9
    },
10
    "relationships": {
11
      "items": {
12
        "data": [
13
          {
14
            "type": "catalog-item",
15
            "id": "string"
16
          }
17
        ],
18
        "links": {
19
          "self": "string",
20
          "related": "string"
21
        }
22
      }
23
    },
24
    "links": {
25
      "self": "string"

201

4XX

5XX