We are currently using Klaviyo's Custom Catalog Feed feature to sync our product catalog via an XML feed,
configured through Content > Products > Manage Custom Catalog Sources in the Klaviyo UI.
Our feed is hosted at an external URL and Klaviyo resyncs it automatically every 6 hours.
The Problem:
Currently, there is no public API endpoint available to programmatically check the sync status of a custom catalog feed source.
The only way to verify whether a sync has succeeded or failed is by manually logging into the Klaviyo UI and checking the Status column under Manage Custom Catalog Sources.
This is not scalable for our team as it requires:
- Daily manual logins to verify sync status
- No ability to automate monitoring or alerting
- No way to integrate sync status checks into our own systems/pipelines
What We Are Looking For:
A public REST API endpoint that allows us to:
1. Retrieve the sync status of a custom catalog feed source (e.g., success, failed, processing)
2. Get error details if a sync has failed
3. See the last synced timestamp
Something similar to how the Web Feeds API returns a status field:
GET /api/catalog-sources
GET /api/catalog-sources/{id}
With a response containing fields like:
json
{
"status": "success | failed | processing",
"last_synced_at": "2026-06-17T00:00:00Z",
"errors": []
}
Why This Matters:
Without this API, teams managing large catalogs cannot automate health monitoring of their catalog sync,
which is critical for ensuring product data is always up to date in marketing emails and flows.
We would greatly appreciate this being added to the Klaviyo public API roadmap.