Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kin Lane

Chat with Kin

AI assistant · trained on my blog

Klaviyo

Klaviyo Catalogs API

catalogs

Documentation Provider Profile APIs.io OpenAPI GitHub

Klaviyo Catalogs API is one of 23 APIs that Klaviyo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Catalogs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, an API reference, authentication docs, and rate-limit docs.

This API exposes 55 operations across 31 paths, and defines 111 schemas. It is described by OpenAPI 3.0.2, at version 2026-04-15.

Requests are made against a single base URL, https://a.klaviyo.com.

55 operations 31 paths 111 schemas 5 DELETE30 GET5 PATCH15 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
2026-04-15
Base URL
https://a.klaviyo.com
Authentication
API Key
Contact
Klaviyo Developer Experience Team
License
License
Terms of Service
View terms
Resource Areas
1

Authentication & Security 1

Klaviyo Catalogs API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Klaviyo-API-Key). By default, every request must be authenticated.

  • Klaviyo-API-Key — Private key authentication for /api/ endpoints is performed by setting the Authorization header to Klaviyo-API-Key your-private-api-key For more information pl…

Paths & Operations 55

Across 31 paths, the API surfaces 55 operations — 5 DELETE, 30 GET, 5 PATCH, 15 POST. Each is listed below with its method, path, parameters, and response codes.

Catalogs 55

catalogs

GET
/api/catalog-items
Get Catalog Items
get_catalog_items 8 params → 2004XX5XX
POST
/api/catalog-items
Create Catalog Item
create_catalog_item 1 param body → 2014XX5XX
GET
/api/catalog-items/{id}
Get Catalog Item
get_catalog_item 5 params → 2004XX5XX
PATCH
/api/catalog-items/{id}
Update Catalog Item
update_catalog_item 2 params body → 2004XX5XX
DELETE
/api/catalog-items/{id}
Delete Catalog Item
delete_catalog_item 2 params → 2044XX5XX
GET
/api/catalog-variants
Get Catalog Variants
get_catalog_variants 6 params → 2004XX5XX
POST
/api/catalog-variants
Create Catalog Variant
create_catalog_variant 1 param body → 2014XX5XX
GET
/api/catalog-variants/{id}
Get Catalog Variant
get_catalog_variant 3 params → 2004XX5XX
PATCH
/api/catalog-variants/{id}
Update Catalog Variant
update_catalog_variant 2 params body → 2004XX5XX
DELETE
/api/catalog-variants/{id}
Delete Catalog Variant
delete_catalog_variant 2 params → 2044XX5XX
GET
/api/catalog-categories
Get Catalog Categories
get_catalog_categories 6 params → 2004XX5XX
POST
/api/catalog-categories
Create Catalog Category
create_catalog_category 1 param body → 2014XX5XX
GET
/api/catalog-categories/{id}
Get Catalog Category
get_catalog_category 3 params → 2004XX5XX
PATCH
/api/catalog-categories/{id}
Update Catalog Category
update_catalog_category 2 params body → 2004XX5XX
DELETE
/api/catalog-categories/{id}
Delete Catalog Category
delete_catalog_category 2 params → 2044XX5XX
GET
/api/catalog-item-bulk-create-jobs
Get Bulk Create Catalog Items Jobs
get_bulk_create_catalog_items_jobs 4 params → 2004XX5XX
POST
/api/catalog-item-bulk-create-jobs
Bulk Create Catalog Items
bulk_create_catalog_items 1 param body → 2024XX5XX
GET
/api/catalog-item-bulk-create-jobs/{job_id}
Get Bulk Create Catalog Items Job
get_bulk_create_catalog_items_job 5 params → 2004XX5XX
GET
/api/catalog-item-bulk-update-jobs
Get Bulk Update Catalog Items Jobs
get_bulk_update_catalog_items_jobs 4 params → 2004XX5XX
POST
/api/catalog-item-bulk-update-jobs
Bulk Update Catalog Items
bulk_update_catalog_items 1 param body → 2024XX5XX
GET
/api/catalog-item-bulk-update-jobs/{job_id}
Get Bulk Update Catalog Items Job
get_bulk_update_catalog_items_job 5 params → 2004XX5XX
GET
/api/catalog-item-bulk-delete-jobs
Get Bulk Delete Catalog Items Jobs
get_bulk_delete_catalog_items_jobs 4 params → 2004XX5XX
POST
/api/catalog-item-bulk-delete-jobs
Bulk Delete Catalog Items
bulk_delete_catalog_items 1 param body → 2024XX5XX
GET
/api/catalog-item-bulk-delete-jobs/{job_id}
Get Bulk Delete Catalog Items Job
get_bulk_delete_catalog_items_job 3 params → 2004XX5XX
GET
/api/catalog-variant-bulk-create-jobs
Get Bulk Create Variants Jobs
get_bulk_create_variants_jobs 4 params → 2004XX5XX
POST
/api/catalog-variant-bulk-create-jobs
Bulk Create Catalog Variants
bulk_create_catalog_variants 1 param body → 2024XX5XX
GET
/api/catalog-variant-bulk-create-jobs/{job_id}
Get Bulk Create Variants Job
get_bulk_create_variants_job 5 params → 2004XX5XX
GET
/api/catalog-variant-bulk-update-jobs
Get Bulk Update Variants Jobs
get_bulk_update_variants_jobs 4 params → 2004XX5XX
POST
/api/catalog-variant-bulk-update-jobs
Bulk Update Catalog Variants
bulk_update_catalog_variants 1 param body → 2024XX5XX
GET
/api/catalog-variant-bulk-update-jobs/{job_id}
Get Bulk Update Variants Job
get_bulk_update_variants_job 5 params → 2004XX5XX
GET
/api/catalog-variant-bulk-delete-jobs
Get Bulk Delete Variants Jobs
get_bulk_delete_variants_jobs 4 params → 2004XX5XX
POST
/api/catalog-variant-bulk-delete-jobs
Bulk Delete Catalog Variants
bulk_delete_catalog_variants 1 param body → 2024XX5XX
GET
/api/catalog-variant-bulk-delete-jobs/{job_id}
Get Bulk Delete Variants Job
get_bulk_delete_variants_job 3 params → 2004XX5XX
GET
/api/catalog-category-bulk-create-jobs
Get Bulk Create Categories Jobs
get_bulk_create_categories_jobs 4 params → 2004XX5XX
POST
/api/catalog-category-bulk-create-jobs
Bulk Create Catalog Categories
bulk_create_catalog_categories 1 param body → 2024XX5XX
GET
/api/catalog-category-bulk-create-jobs/{job_id}
Get Bulk Create Categories Job
get_bulk_create_categories_job 5 params → 2004XX5XX
GET
/api/catalog-category-bulk-update-jobs
Get Bulk Update Categories Jobs
get_bulk_update_categories_jobs 4 params → 2004XX5XX
POST
/api/catalog-category-bulk-update-jobs
Bulk Update Catalog Categories
bulk_update_catalog_categories 1 param body → 2024XX5XX
GET
/api/catalog-category-bulk-update-jobs/{job_id}
Get Bulk Update Categories Job
get_bulk_update_categories_job 5 params → 2004XX5XX
GET
/api/catalog-category-bulk-delete-jobs
Get Bulk Delete Categories Jobs
get_bulk_delete_categories_jobs 4 params → 2004XX5XX
POST
/api/catalog-category-bulk-delete-jobs
Bulk Delete Catalog Categories
bulk_delete_catalog_categories 1 param body → 2024XX5XX
GET
/api/catalog-category-bulk-delete-jobs/{job_id}
Get Bulk Delete Categories Job
get_bulk_delete_categories_job 3 params → 2004XX5XX
POST
/api/back-in-stock-subscriptions
Create Back In Stock Subscription
create_back_in_stock_subscription 1 param body → 2024XX5XX
GET
/api/catalog-categories/{id}/items
Get Items for Catalog Category
get_items_for_catalog_category 9 params → 2004XX5XX
GET
/api/catalog-categories/{id}/relationships/items
Get Item IDs for Catalog Category
get_item_ids_for_catalog_category 6 params → 2004XX5XX
POST
/api/catalog-categories/{id}/relationships/items
Add Items to Catalog Category
add_items_to_catalog_category 2 params body → 2044XX5XX
PATCH
/api/catalog-categories/{id}/relationships/items
Update Items for Catalog Category
update_items_for_catalog_category 2 params body → 2044XX5XX
DELETE
/api/catalog-categories/{id}/relationships/items
Remove Items from Catalog Category
remove_items_from_catalog_category 2 params body → 2044XX5XX
GET
/api/catalog-items/{id}/variants
Get Variants for Catalog Item
get_variants_for_catalog_item 7 params → 2004XX5XX
GET
/api/catalog-items/{id}/relationships/variants
Get Variant IDs for Catalog Item
get_variant_ids_for_catalog_item 6 params → 2004XX5XX
GET
/api/catalog-items/{id}/categories
Get Categories for Catalog Item
get_categories_for_catalog_item 7 params → 2004XX5XX
GET
/api/catalog-items/{id}/relationships/categories
Get Category IDs for Catalog Item
get_category_ids_for_catalog_item 6 params → 2004XX5XX
POST
/api/catalog-items/{id}/relationships/categories
Add Categories to Catalog Item
add_categories_to_catalog_item 2 params body → 2044XX5XX
PATCH
/api/catalog-items/{id}/relationships/categories
Update Categories for Catalog Item
update_categories_for_catalog_item 2 params body → 2044XX5XX
DELETE
/api/catalog-items/{id}/relationships/categories
Remove Categories from Catalog Item
remove_categories_from_catalog_item 2 params body → 2044XX5XX

Schemas 111

The contract defines 111 schemas that model the data the API accepts and returns. The most detailed are CatalogVariantDeleteJobResponseObjectResource (5 properties), CatalogVariantResponseObjectResource (5 properties), CatalogItemResponseObjectResource (5 properties), CatalogItemDeleteJobResponseObjectResource (5 properties). Each schema is shown below with its type and property counts.

PostCatalogItemDeleteJobResponse
object
2 properties 1 required
CatalogVariantDeleteQueryResourceObject
object
2 properties 2 required
GetCatalogVariantCreateJobResponseCompoundDocument
object
3 properties 1 required
CatalogVariantBulkCreateJobEnum
string
CatalogCategoryCreateJobCreateQueryResourceObject
object
2 properties 2 required
CatalogItemUpdateQuery
object
1 property 1 required
ServerBISSubscriptionCreateQuery
object
1 property 1 required
PostCatalogItemResponse
object
2 properties 1 required
GetCatalogItemVariantsRelationshipsResponseCollection
object
2 properties 1 required
GetCatalogItemCreateJobResponseCollectionCompoundDocument
object
2 properties 1 required
CatalogCategoryItemOp
object
1 property 1 required
ProfileEnum
string
CatalogItemCategoryOp
object
1 property 1 required
PostCatalogCategoryUpdateJobResponse
object
2 properties 1 required
CatalogVariantResponseObjectResource
object
5 properties 4 required
GetCatalogVariantUpdateJobResponseCompoundDocument
object
3 properties 1 required
CatalogCategoryBulkUpdateJobEnum
string
ObjectLinks
object
1 property 1 required
GetCatalogVariantDeleteJobResponseCollection
object
2 properties 1 required
GetCatalogItemResponseCompoundDocument
object
3 properties 1 required
CatalogVariantBulkUpdateJobEnum
string
GetCatalogItemDeleteJobResponseCollection
object
2 properties 1 required
CatalogItemUpdateQueryResourceObject
object
4 properties 3 required
CatalogVariantCreateQueryResourceObject
object
3 properties 3 required
CatalogItemUpdateJobResponseObjectResource
object
5 properties 4 required
CatalogVariantDeleteJobResponseObjectResource
object
5 properties 4 required
CatalogVariantDeleteJobCreateQuery
object
1 property 1 required
PostCatalogItemCreateJobResponse
object
2 properties 1 required
CatalogItemBulkDeleteJobEnum
string
CatalogCategoryUpdateQuery
object
1 property 1 required
GetCatalogItemUpdateJobResponseCompoundDocument
object
3 properties 1 required
PostCatalogCategoryDeleteJobResponse
object
2 properties 1 required
CatalogCategoryUpdateJobCreateQueryResourceObject
object
2 properties 2 required
CatalogItemCreateJobCreateQueryResourceObject
object
2 properties 2 required
CatalogVariantCreateQuery
object
1 property 1 required
PatchCatalogCategoryResponse
object
2 properties 1 required
GetCatalogCategoryResponseCollection
object
2 properties 1 required
GetCatalogItemUpdateJobResponseCollectionCompoundDocument
object
2 properties 1 required
CatalogItemCreateQueryResourceObject
object
3 properties 2 required
GetCatalogCategoryUpdateJobResponseCollectionCompoundDocument
object
2 properties 1 required
BackInStockSubscriptionEnum
string
CatalogVariantUpdateJobCreateQuery
object
1 property 1 required
CatalogItemResponseObjectResource
object
5 properties 4 required
GetCatalogVariantDeleteJobResponse
object
2 properties 1 required
ServerBISSubscriptionCreateQueryResourceObject
object
3 properties 3 required
GetCatalogItemResponseCollectionCompoundDocument
object
3 properties 1 required
GetCatalogCategoryDeleteJobResponse
object
2 properties 1 required
PatchCatalogItemResponse
object
2 properties 1 required
RelationshipLinks
object
2 properties 2 required
CatalogCategoryCreateJobResponseObjectResource
object
5 properties 4 required
CatalogVariantEnum
string
GetCatalogCategoryItemsRelationshipsResponseCollection
object
2 properties 1 required
CatalogItemEnum
string
CatalogVariantUpdateJobCreateQueryResourceObject
object
2 properties 2 required
CatalogVariantDeleteJobCreateQueryResourceObject
object
2 properties 2 required
CatalogItemBulkCreateJobEnum
string
CatalogCategoryEnum
string
CatalogItemBulkUpdateJobEnum
string
PostCatalogItemUpdateJobResponse
object
2 properties 1 required
ErrorSource
object
1 property
PostCatalogVariantCreateJobResponse
object
2 properties 1 required
PostCatalogVariantUpdateJobResponse
object
2 properties 1 required
CatalogVariantUpdateQueryResourceObject
object
3 properties 3 required
CatalogItemCreateQuery
object
1 property 1 required
CatalogVariantUpdateJobResponseObjectResource
object
5 properties 4 required
CatalogCategoryUpdateJobCreateQuery
object
1 property 1 required
GetCatalogCategoryCreateJobResponseCompoundDocument
object
3 properties 1 required
GetCatalogCategoryCreateJobResponseCollectionCompoundDocument
object
2 properties 1 required
GetCatalogCategoryResponse
object
2 properties 1 required
CatalogVariantBulkDeleteJobEnum
string
CatalogCategoryBulkDeleteJobEnum
string
PostCatalogCategoryCreateJobResponse
object
2 properties 1 required
GetCatalogVariantResponse
object
2 properties 1 required
CatalogCategoryUpdateQueryResourceObject
object
4 properties 3 required
PostCatalogVariantDeleteJobResponse
object
2 properties 1 required
CatalogCategoryBulkCreateJobEnum
string
GetCatalogItemCreateJobResponseCompoundDocument
object
3 properties 1 required
ProfileIdentifierDTOResourceObject
object
3 properties 2 required
PostCatalogVariantResponse
object
2 properties 1 required
CatalogItemDeleteJobCreateQueryResourceObject
object
2 properties 2 required
CatalogCategoryDeleteJobCreateQueryResourceObject
object
2 properties 2 required
CatalogVariantUpdateQuery
object
1 property 1 required
CatalogItemDeleteQueryResourceObject
object
2 properties 2 required
GetCatalogVariantUpdateJobResponseCollectionCompoundDocument
object
2 properties 1 required
CatalogCategoryCreateQueryResourceObject
object
3 properties 2 required
PostCatalogCategoryResponse
object
2 properties 1 required
GetCatalogVariantResponseCollection
object
2 properties 1 required
CatalogItemCreateJobCreateQuery
object
1 property 1 required
CatalogItemCreateJobResponseObjectResource
object
5 properties 4 required
CatalogCategoryUpdateJobResponseObjectResource
object
5 properties 4 required
GetCatalogCategoryUpdateJobResponseCompoundDocument
object
3 properties 1 required
APIJobErrorPayload
object
5 properties 5 required
CatalogItemDeleteJobResponseObjectResource
object
5 properties 4 required
CatalogVariantCreateJobCreateQueryResourceObject
object
2 properties 2 required
CatalogCategoryCreateQuery
object
1 property 1 required
CatalogItemDeleteJobCreateQuery
object
1 property 1 required
CatalogItemUpdateJobCreateQueryResourceObject
object
2 properties 2 required
CatalogCategoryDeleteJobCreateQuery
object
1 property 1 required
CatalogVariantCreateJobResponseObjectResource
object
5 properties 4 required
GetCatalogCategoryDeleteJobResponseCollection
object
2 properties 1 required
CatalogCategoryCreateJobCreateQuery
object
1 property 1 required
GetCatalogItemDeleteJobResponse
object
2 properties 1 required
CatalogCategoryResponseObjectResource
object
5 properties 4 required
CatalogItemUpdateJobCreateQuery
object
1 property 1 required
CatalogVariantCreateJobCreateQuery
object
1 property 1 required
GetCatalogItemCategoriesRelationshipsResponseCollection
object
2 properties 1 required
CatalogCategoryDeleteQueryResourceObject
object
2 properties 2 required
GetCatalogVariantCreateJobResponseCollectionCompoundDocument
object
2 properties 1 required
PatchCatalogVariantResponse
object
2 properties 1 required
CollectionLinks
object
5 properties 1 required
CatalogCategoryDeleteJobResponseObjectResource
object
5 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-catalogs-api-openapi.yml Raw ↑

Other APIs Klaviyo publishes across the network.

Klaviyo Accounts API
AE Profile APIs.io
Klaviyo Campaigns API
AE Profile APIs.io
Klaviyo Client API
AE Profile APIs.io
Klaviyo Conversations API
AE Profile APIs.io
Klaviyo Coupons API
AE Profile APIs.io
Klaviyo Custom Objects API
AE Profile APIs.io
Klaviyo Data Privacy API
AE Profile APIs.io
Klaviyo Events API
AE Profile APIs.io
Klaviyo Flows API
AE Profile APIs.io
Klaviyo Forms API
AE Profile APIs.io
Klaviyo Images API
AE Profile APIs.io
Klaviyo Lists API
AE Profile APIs.io
#Catalogs
← Back to K APIs
API Details
ID
klaviyo:klaviyo-catalogs-api
Base URL
https://a.klaviyo.com
Docs
https://developers.klaviyo.com/
Provider
Klaviyo
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network