{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a new catalog category.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/create_catalog_category.json)","properties":{"query":{"type":"object","properties":{"fields[catalog-category]":{"type":"array","items":{"type":"string","enum":["external_id","id","name","updated"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"}},"required":[],"additionalProperties":false},"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false},"body":{"$ref":"#/definitions/CatalogCategoryCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"CatalogCategoryCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/CatalogCategoryCreateQueryResourceObject"}},"required":["data"]},"CatalogCategoryCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/CatalogCategoryEnum"},"attributes":{"type":"object","properties":{"external_id":{"description":"The ID of the catalog category in an external system.","type":"string","examples":["SAMPLE-DATA-CATEGORY-APPAREL"]},"name":{"description":"The name of the catalog category.","type":"string","examples":["Sample Data Category Apparel"]},"integration_type":{"description":"The integration type. Currently only \"$custom\" is supported.","type":["string","null"],"default":"$custom","enum":["$custom"],"examples":["$custom"]},"catalog_type":{"description":"The type of catalog. Currently only \"$default\" is supported.","type":["string","null"],"default":"$default","examples":["$default"]}},"required":["external_id","name"]},"relationships":{"type":"object","properties":{"items":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["type","id"],"properties":{"type":{"$ref":"#/definitions/CatalogItemEnum"},"id":{"description":"A list of catalog item IDs that are in the given category.","type":"string","examples":["$custom:::$default:::SAMPLE-DATA-ITEM-1"]}}}}}}}}},"required":["type","attributes"]},"CatalogCategoryEnum":{"type":"string","enum":["catalog-category"]},"CatalogItemEnum":{"type":"string","enum":["catalog-item"]}}},"name":"Create Catalog Category","id":"klaviyo.create_catalog_category","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"catalog-category","attributes":{"external_id":"SAMPLE-DATA-CATEGORY-APPAREL","name":"Sample Data Category Apparel"}}}},"maxRequests":1,"summary":false}}