Klaviyo is your e-commerce marketing brain — predictive analytics, flow automation, segmentation, product catalogs, and multi-channel messaging. These five jobs connect Klaviyo’s data to Mavera’s surfaces (Custom Personas, Generate, Mave Agent, Focus Groups) so your personas reflect real CLV tiers, your underperforming flows get data-driven rewrites, and your creative decisions are tested before sending.Documentation Index
Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
Use this file to discover all available pages before exploring further.
API Reference Card
| Detail | Value |
|---|---|
| Base URL | https://a.klaviyo.com/api/ |
| Auth | Klaviyo-API-Key header (private API key) |
| Rate limits | Tiered — 1 to 350 req/sec burst depending on endpoint and plan |
| Revision header | Required: revision: 2024-10-15 (or latest) |
| Mavera base | https://app.mavera.io/api/v1 |
| Mavera auth | Authorization: Bearer mvra_live_... |
All examples use two environment variables:
KLAVIYO_API_KEY (your private API key, starts with pk_) and MAVERA_API_KEY. Klaviyo’s API requires a revision header on every request — the examples use 2024-10-15. Python examples use requests; JavaScript examples use fetch.Prerequisites
Klaviyo account with data
You need an active Klaviyo account with at least 30 days of tracked events, profile data, and predictive analytics enabled (available on Growth+ plans).
Private API key
Generate a private key in Klaviyo → Settings → API Keys. Grant the key read access to Profiles, Segments, Metrics, Campaigns, and Flows.
Predictive analytics
Predictive CLV, churn risk, and next purchase date require sufficient order history. Klaviyo needs ~180 days of order data and 500+ customers to generate predictions.
Mavera API key
Get your key from Mavera dashboard.
Jobs
| # | Job | Klaviyo Data | Mavera Surface | Output |
|---|---|---|---|---|
| 1 | Predictive Analytics → Persona Enrichment | Profiles with predictive CLV/churn | Custom Personas | CLV-tier personas with churn profiles |
| 2 | Flow Performance → Content Refresh | Metric aggregates (flow-level) | Generate | Rewritten underperforming flow content |
| 3 | Segment Overlap Analysis | Segments + member counts | Mave Agent | Simplified segmentation recommendations |
| 4 | Product Affinity → Focus Group | Catalog + purchase data | Focus Groups | Cross-sell validation with Likert + NPS |
| 5 | SMS vs. Email Creative Testing | SMS + email campaign performance | Focus Groups | Channel preference insights |
Rate Limits & Production Notes
| Klaviyo API | Limit | Strategy |
|---|---|---|
| Profiles GET | 10-75 req/sec (plan-dependent) | Respect Retry-After; paginate with cursors |
| Segments GET | 10-15 req/sec | Cache segment lists; definitions change rarely |
| Catalog Items | 10-75 req/sec | Cache catalog; changes are event-driven |
| Metric Aggregates POST | 3-10 req/sec | Batch time periods; cache results |
| Flows GET | 10-15 req/sec | Cache flow structures; metrics are separate |
| Concern | Recommendation |
|---|---|
| API key security | Klaviyo private keys (pk_) have full read access. Never expose in client-side code. Use server-side calls only. |
| Revision header | Pin to a specific revision and test before upgrading. Breaking changes are released per-revision, not silently. |
| Predictive analytics lag | Predictive CLV and churn risk update daily. Don’t poll more than once per 24 hours for persona enrichment. |
| Catalog sync | Catalog data comes from your e-commerce platform integration (Shopify, BigCommerce, etc.). Ensure the sync is active before querying catalog items. |
| Mavera credits | Monitor at Dashboard. Job 4 (product affinity) with 3 personas × 5 questions × 2 responses is credit-intensive. |
| SMS compliance | Always respect SMS opt-in preferences. Never send promotional SMS without explicit consent. Klaviyo enforces this at the platform level. |
What’s Next
All Integrations
50+ API integrations with full code
Klaviyo API Docs
Official Klaviyo API reference
Personas API
Full reference for POST /api/v1/personas
Focus Groups API
Full reference for POST /api/v1/focus-groups
Mave Agent
Full reference for POST /api/v1/mave/chat
Generate API
Full reference for POST /api/v1/generations