{
"opencollection": "1.0.0",
"info": {
"name": "Klaviyo Accounts Catalogs API",
"version": "2026-04-15"
},
"request": {
"auth": {
"type": "apikey",
"key": "Authorization",
"value": "{{Authorization}}",
"placement": "header"
}
},
"items": [
{
"info": {
"name": "Catalogs",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get Catalog Items",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-items",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-item]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "fields[catalog-variant]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`ids`: `any`
`category.id`: `equals`
`title`: `contains`
`published`: `equals`"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
},
{
"name": "page[size]",
"value": "",
"type": "query",
"description": "Default: 100. Min: 1. Max: 100."
},
{
"name": "sort",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
}
]
},
"docs": "Get all catalog items in an account.\n\nCatalog items can be sorted by the following fields, in ascending and descending order:\n`created`\n\nCurrently, the only supported integration type is `$custom`, and the only supported catalog type is `$default`.\n\nReturns a maximum of 100 items per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Create Catalog Item",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-items",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a new catalog item.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Catalog Item",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-items/:id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
},
{
"name": "fields[catalog-item]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "fields[catalog-variant]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
}
]
},
"docs": "Get a specific catalog item with the given item ID.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Update Catalog Item",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://a.klaviyo.com/api/catalog-items/:id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Update a catalog item with the given item ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Delete Catalog Item",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://a.klaviyo.com/api/catalog-items/:id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
]
},
"docs": "Delete a catalog item with the given item ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Catalog Variants",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-variants",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-variant]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`ids`: `any`
`item.id`: `equals`
`sku`: `equals`
`title`: `contains`
`published`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
},
{
"name": "page[size]",
"value": "",
"type": "query",
"description": "Default: 100. Min: 1. Max: 100."
},
{
"name": "sort",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
}
]
},
"docs": "Get all variants in an account.\n\nVariants can be sorted by the following fields, in ascending and descending order:\n`created`\n\nCurrently, the only supported integration type is `$custom`, and the only supported catalog type is `$default`.\n\nReturns a maximum of 100 variants per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Create Catalog Variant",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-variants",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a new variant for a related catalog item.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Catalog Variant",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-variants/:id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog variant ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
},
{
"name": "fields[catalog-variant]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
}
]
},
"docs": "Get a catalog item variant with the given variant ID.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Update Catalog Variant",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://a.klaviyo.com/api/catalog-variants/:id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog variant ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Update a catalog item variant with the given variant ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Delete Catalog Variant",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://a.klaviyo.com/api/catalog-variants/:id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog variant ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
]
},
"docs": "Delete a catalog item variant with the given variant ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Catalog Categories",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-categories",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-category]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`ids`: `any`
`item.id`: `equals`
`name`: `contains`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
},
{
"name": "page[size]",
"value": "",
"type": "query",
"description": "Default: 100. Min: 1. Max: 100."
},
{
"name": "sort",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
}
]
},
"docs": "Get all catalog categories in an account.\n\nCatalog categories can be sorted by the following fields, in ascending and descending order:\n`created`\n\nCurrently, the only supported integration type is `$custom`, and the only supported catalog type is `$default`.\n\nReturns a maximum of 100 categories per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Create Catalog Category",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-categories",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a new catalog category.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Catalog Category",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-categories/:id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog category ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
},
{
"name": "fields[catalog-category]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
}
]
},
"docs": "Get a catalog category with the given category ID.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Update Catalog Category",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://a.klaviyo.com/api/catalog-categories/:id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog category ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Update a catalog category with the given category ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Delete Catalog Category",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://a.klaviyo.com/api/catalog-categories/:id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog category ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
]
},
"docs": "Delete a catalog category using the given category ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Create Catalog Items Jobs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-item-bulk-create-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-item-bulk-create-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`status`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
}
]
},
"docs": "Get all catalog item bulk create jobs.\n\nReturns a maximum of 100 jobs per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Bulk Create Catalog Items",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-item-bulk-create-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a catalog item bulk create job to create a batch of catalog items.\n\nAccepts up to 100 catalog items per request. The maximum allowed payload size is 5MB.\nThe maximum number of jobs in progress at one time is 500.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Create Catalog Items Job",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-item-bulk-create-jobs/:job_id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "job_id",
"value": "",
"type": "path",
"description": "ID of the job to retrieve."
},
{
"name": "fields[catalog-item-bulk-create-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "fields[catalog-item]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
}
]
},
"docs": "Get a catalog item bulk create job with the given job ID.\n\nAn `include` parameter can be provided to get the following related resource data: `items`.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Bulk Update Catalog Items Jobs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-item-bulk-update-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-item-bulk-update-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`status`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
}
]
},
"docs": "Get all catalog item bulk update jobs.\n\nReturns a maximum of 100 jobs per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Bulk Update Catalog Items",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-item-bulk-update-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a catalog item bulk update job to update a batch of catalog items.\n\nAccepts up to 100 catalog items per request. The maximum allowed payload size is 5MB.\nThe maximum number of jobs in progress at one time is 500.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Update Catalog Items Job",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-item-bulk-update-jobs/:job_id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "job_id",
"value": "",
"type": "path",
"description": "ID of the job to retrieve."
},
{
"name": "fields[catalog-item-bulk-update-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "fields[catalog-item]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
}
]
},
"docs": "Get a catalog item bulk update job with the given job ID.\n\nAn `include` parameter can be provided to get the following related resource data: `items`.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Bulk Delete Catalog Items Jobs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-item-bulk-delete-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-item-bulk-delete-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`status`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
}
]
},
"docs": "Get all catalog item bulk delete jobs.\n\nReturns a maximum of 100 jobs per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Bulk Delete Catalog Items",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-item-bulk-delete-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a catalog item bulk delete job to delete a batch of catalog items.\n\nAccepts up to 100 catalog items per request. The maximum allowed payload size is 5MB.\nThe maximum number of jobs in progress at one time is 500.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Delete Catalog Items Job",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-item-bulk-delete-jobs/:job_id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "job_id",
"value": "",
"type": "path",
"description": "ID of the job to retrieve."
},
{
"name": "fields[catalog-item-bulk-delete-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
}
]
},
"docs": "Get a catalog item bulk delete job with the given job ID.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Bulk Create Variants Jobs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-variant-bulk-create-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-variant-bulk-create-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`status`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
}
]
},
"docs": "Get all catalog variant bulk create jobs.\n\nReturns a maximum of 100 jobs per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Bulk Create Catalog Variants",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-variant-bulk-create-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a catalog variant bulk create job to create a batch of catalog variants.\n\nAccepts up to 100 catalog variants per request. The maximum allowed payload size is 5MB.\nThe maximum number of jobs in progress at one time is 500.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Create Variants Job",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-variant-bulk-create-jobs/:job_id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "job_id",
"value": "",
"type": "path",
"description": "ID of the job to retrieve."
},
{
"name": "fields[catalog-variant-bulk-create-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "fields[catalog-variant]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
}
]
},
"docs": "Get a catalog variant bulk create job with the given job ID.\n\nAn `include` parameter can be provided to get the following related resource data: `variants`.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Bulk Update Variants Jobs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-variant-bulk-update-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-variant-bulk-update-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`status`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
}
]
},
"docs": "Get all catalog variant bulk update jobs.\n\nReturns a maximum of 100 jobs per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Bulk Update Catalog Variants",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-variant-bulk-update-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a catalog variant bulk update job to update a batch of catalog variants.\n\nAccepts up to 100 catalog variants per request. The maximum allowed payload size is 5MB.\nThe maximum number of jobs in progress at one time is 500.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Update Variants Job",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-variant-bulk-update-jobs/:job_id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "job_id",
"value": "",
"type": "path",
"description": "ID of the job to retrieve."
},
{
"name": "fields[catalog-variant-bulk-update-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "fields[catalog-variant]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
}
]
},
"docs": "Get a catalog variate bulk update job with the given job ID.\n\nAn `include` parameter can be provided to get the following related resource data: `variants`.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Bulk Delete Variants Jobs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-variant-bulk-delete-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-variant-bulk-delete-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`status`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
}
]
},
"docs": "Get all catalog variant bulk delete jobs.\n\nReturns a maximum of 100 jobs per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Bulk Delete Catalog Variants",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-variant-bulk-delete-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a catalog variant bulk delete job to delete a batch of catalog variants.\n\nAccepts up to 100 catalog variants per request. The maximum allowed payload size is 5MB.\nThe maximum number of jobs in progress at one time is 500.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Delete Variants Job",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-variant-bulk-delete-jobs/:job_id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "job_id",
"value": "",
"type": "path",
"description": "ID of the job to retrieve."
},
{
"name": "fields[catalog-variant-bulk-delete-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
}
]
},
"docs": "Get a catalog variant bulk delete job with the given job ID.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Bulk Create Categories Jobs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-category-bulk-create-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-category-bulk-create-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`status`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
}
]
},
"docs": "Get all catalog category bulk create jobs.\n\nReturns a maximum of 100 jobs per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Bulk Create Catalog Categories",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-category-bulk-create-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a catalog category bulk create job to create a batch of catalog categories.\n\nAccepts up to 100 catalog categories per request. The maximum allowed payload size is 5MB.\nThe maximum number of jobs in progress at one time is 500.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Create Categories Job",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-category-bulk-create-jobs/:job_id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "job_id",
"value": "",
"type": "path",
"description": "ID of the job to retrieve."
},
{
"name": "fields[catalog-category-bulk-create-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "fields[catalog-category]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
}
]
},
"docs": "Get a catalog category bulk create job with the given job ID.\n\nAn `include` parameter can be provided to get the following related resource data: `categories`.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Bulk Update Categories Jobs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-category-bulk-update-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-category-bulk-update-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`status`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
}
]
},
"docs": "Get all catalog category bulk update jobs.\n\nReturns a maximum of 100 jobs per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Bulk Update Catalog Categories",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-category-bulk-update-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a catalog category bulk update job to update a batch of catalog categories.\n\nAccepts up to 100 catalog categories per request. The maximum allowed payload size is 5MB.\nThe maximum number of jobs in progress at one time is 500.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Update Categories Job",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-category-bulk-update-jobs/:job_id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "job_id",
"value": "",
"type": "path",
"description": "ID of the job to retrieve."
},
{
"name": "fields[catalog-category-bulk-update-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "fields[catalog-category]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
}
]
},
"docs": "Get a catalog category bulk update job with the given job ID.\n\nAn `include` parameter can be provided to get the following related resource data: `categories`.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Bulk Delete Categories Jobs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-category-bulk-delete-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "fields[catalog-category-bulk-delete-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`status`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
}
]
},
"docs": "Get all catalog category bulk delete jobs.\n\nReturns a maximum of 100 jobs per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Bulk Delete Catalog Categories",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-category-bulk-delete-jobs",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a catalog category bulk delete job to delete a batch of catalog categories.\n\nAccepts up to 100 catalog categories per request. The maximum allowed payload size is 5MB.\nThe maximum number of jobs in progress at one time is 500.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Bulk Delete Categories Job",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-category-bulk-delete-jobs/:job_id",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "job_id",
"value": "",
"type": "path",
"description": "ID of the job to retrieve."
},
{
"name": "fields[catalog-category-bulk-delete-job]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
}
]
},
"docs": "Get a catalog category bulk delete job with the given job ID.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Create Back In Stock Subscription",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/back-in-stock-subscriptions",
"headers": [
{
"name": "revision",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Subscribe a profile to receive back in stock notifications. Check out [our Back in Stock API guide](https://developers.klaviyo.com/en/docs/how_to_set_up_custom_back_in_stock) for more details.\n\nThis endpoint is specifically designed to be called from server-side applications. To create subscriptions from client-side contexts, use [POST /client/back-in-stock-subscriptions](https://developers.klaviyo.com/en/reference/create_client_back_in_stock_subscription).
*Rate limits*:
Burst: `350/s"
},
{
"info": {
"name": "Get Items for Catalog Category",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-categories/:id/items",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog category ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
},
{
"name": "fields[catalog-item]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "fields[catalog-variant]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`ids`: `any`
`category.id`: `equals`
`title`: `contains`
`published`: `equals`"
},
{
"name": "include",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
},
{
"name": "page[size]",
"value": "",
"type": "query",
"description": "Default: 100. Min: 1. Max: 100."
},
{
"name": "sort",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
}
]
},
"docs": "Get all items in a category with the given category ID.\n\nItems can be sorted by the following fields, in ascending and descending order:\n`created`\n\nReturns a maximum of 100 items per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Item IDs for Catalog Category",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-categories/:id/relationships/items",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog category ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`ids`: `any`
`category.id`: `equals`
`title`: `contains`
`published`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
},
{
"name": "page[size]",
"value": "",
"type": "query",
"description": "Default: 100. Min: 1. Max: 100."
},
{
"name": "sort",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
}
]
},
"docs": "Get all items in the given category ID. Returns a maximum of 100 items per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Add Items to Catalog Category",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-categories/:id/relationships/items",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog category ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a new item relationship for the given category ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Update Items for Catalog Category",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://a.klaviyo.com/api/catalog-categories/:id/relationships/items",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog category ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Update item relationships for the given category ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Remove Items from Catalog Category",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://a.klaviyo.com/api/catalog-categories/:id/relationships/items",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog category ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Delete item relationships for the given category ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Get Variants for Catalog Item",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-items/:id/variants",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
},
{
"name": "fields[catalog-variant]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`ids`: `any`
`item.id`: `equals`
`sku`: `equals`
`title`: `contains`
`published`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
},
{
"name": "page[size]",
"value": "",
"type": "query",
"description": "Default: 100. Min: 1. Max: 100."
},
{
"name": "sort",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
}
]
},
"docs": "Get all variants related to the given item ID.\n\nVariants can be sorted by the following fields, in ascending and descending order:\n`created`\n\nReturns a maximum of 100 variants per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Variant IDs for Catalog Item",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-items/:id/relationships/variants",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`ids`: `any`
`item.id`: `equals`
`sku`: `equals`
`title`: `contains`
`published`: `equals`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
},
{
"name": "page[size]",
"value": "",
"type": "query",
"description": "Default: 100. Min: 1. Max: 100."
},
{
"name": "sort",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
}
]
},
"docs": "Get all variants related to the given item ID.\n\nVariants can be sorted by the following fields, in ascending and descending order:\n`created`\n\nReturns a maximum of 100 variants per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Categories for Catalog Item",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-items/:id/categories",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
},
{
"name": "fields[catalog-category]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`ids`: `any`
`item.id`: `equals`
`name`: `contains`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
},
{
"name": "page[size]",
"value": "",
"type": "query",
"description": "Default: 100. Min: 1. Max: 100."
},
{
"name": "sort",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
}
]
},
"docs": "Get all catalog categories that an item with the given item ID is in.\n\nCatalog categories can be sorted by the following fields, in ascending and descending order:\n`created`\n\nReturns a maximum of 100 categories per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Get Category IDs for Catalog Item",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://a.klaviyo.com/api/catalog-items/:id/relationships/categories",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`ids`: `any`
`item.id`: `equals`
`name`: `contains`"
},
{
"name": "page[cursor]",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
},
{
"name": "page[size]",
"value": "",
"type": "query",
"description": "Default: 100. Min: 1. Max: 100."
},
{
"name": "sort",
"value": "",
"type": "query",
"description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
}
]
},
"docs": "Get all catalog categories that a particular item is in. Returns a maximum of 100 categories per request.
*Rate limits*:
Burst: `350/s`
Steady: `3500/m`\n\n**Scopes:**\n`catalogs:read`"
},
{
"info": {
"name": "Add Categories to Catalog Item",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://a.klaviyo.com/api/catalog-items/:id/relationships/categories",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a new catalog category relationship for the given item ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Update Categories for Catalog Item",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://a.klaviyo.com/api/catalog-items/:id/relationships/categories",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Update catalog category relationships for the given item ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
},
{
"info": {
"name": "Remove Categories from Catalog Item",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://a.klaviyo.com/api/catalog-items/:id/relationships/categories",
"headers": [
{
"name": "revision",
"value": ""
}
],
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Delete catalog category relationships for the given item ID.
*Rate limits*:
Burst: `75/s`
Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`"
}
]
}
],
"bundled": true
}