{ "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 }