Klaviyo API

Name: Klaviyo API API
Brand: Klaviyo API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMarketingMarketing AutomationapiKey289 EndpointsREST

For Agents

Trigger personalized email and SMS campaigns, manage customer profiles and segments, track behavioral events, and orchestrate multi-step marketing flows. Covers 289 endpoints with deep e-commerce catalog and event-driven automation support.

Quickstart

Get started with Klaviyo API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"send a personalized email campaign to a customer segment"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Klaviyo API API.

Trigger multi-step marketing flows based on real-time customer events like purchases, page views, and cart additions

Build predictive segments using customer lifetime value, churn risk, and expected purchase date scores

Sync product catalogs with variants, categories, and pricing for personalized product recommendations in emails

Track custom events with properties to build behavioral cohorts and trigger targeted campaign sends

GET STARTED

Start building with Klaviyo API API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Klaviyo API API for, with concrete tasks.

★ AI Agent Marketing Automation

AI agents use the Klaviyo API through Jentic to programmatically create campaigns, manage customer profiles, and trigger flow actions based on behavioral events. The agent searches for 'send targeted campaign to segment' via Jentic, receives the matching operation schemas for /api/campaigns and /api/campaign-send-jobs, and executes the full workflow. Klaviyo's event-driven architecture means agents can track any custom event and build automation triggers without manual flow configuration. Integration takes under an hour through Jentic versus 3-5 days for direct OAuth setup and webhook configuration.

Create a campaign targeting the 'High-Value Customers' segment with a personalized product recommendation email and schedule it for optimal send time

Behavioral Event Tracking and Segmentation

Track granular customer behavior events including purchases, page views, product interactions, and custom events via the /api/events endpoint. Each event carries typed properties that feed into Klaviyo's segmentation engine, enabling real-time audience building based on recency, frequency, and monetary value. Segments update dynamically as new events arrive, powering flow triggers and campaign targeting without manual list management across audiences of millions.

Track a 'Product Viewed' event for profile ID 'abc123' with properties including product_id, price, and category, then verify the event appears in the profile's event timeline

E-Commerce Catalog Sync and Product Recommendations

Sync product catalogs including items, variants, and categories via bulk import jobs at /api/catalog-item-bulk-create-jobs. Catalog data powers personalized product recommendation blocks in emails and SMS, showing each recipient items relevant to their browsing and purchase history. Supports incremental updates through individual item endpoints and bulk operations handling thousands of products per batch.

Import 100 catalog items with variants using a bulk create job, wait for completion, then verify the items appear in the catalog

Multi-Channel Flow Orchestration

Retrieve and monitor automated flows that span email, SMS, and push notification channels via the /api/flows endpoint. Each flow contains actions with conditional splits, time delays, and channel-specific content. The API exposes flow performance including conversion rates, revenue generated per flow, and per-action engagement metrics. Agents can identify underperforming flow steps and trigger updates to improve downstream conversion.

Get all flows tagged with 'post-purchase', retrieve their per-action metrics, and identify any flow action with less than 5% click rate

Customer Profile Enrichment and Lifecycle Analysis

Import, update, and query customer profiles containing behavioral properties, predictive analytics scores, and subscription statuses. The /api/profiles endpoint supports bulk imports via /api/profile-bulk-import-jobs processing thousands of profiles per batch. Each profile aggregates email engagement, purchase value, predicted next order date, and churn risk scores — enabling lifecycle-based segmentation and personalized outreach timing.

Bulk import 500 customer profiles with email, first name, and custom properties, then create a segment of profiles with predicted churn risk above 0.7

Key Endpoints

289 endpoints — orchestrate personalized email, sms, and push marketing campaigns driven by real-time customer behavior data.

METHOD

PATH

DESCRIPTION

POST

/api/campaigns

Create a new campaign

POST

/api/campaign-send-jobs

Trigger a campaign send

GET

/api/profiles

List customer profiles

POST

/api/events

Track a customer event

GET

/api/flows

List all automation flows

GET

/api/segments

List audience segments

POST

/api/lists/{id}/relationships/profiles

Add profiles to a list

POST

/api/catalog-item-bulk-create-jobs

Bulk import catalog items

POST

/api/campaigns

Create a new campaign

POST

/api/campaign-send-jobs

Trigger a campaign send

GET

/api/profiles

List customer profiles

POST

/api/events

Track a customer event

GET

/api/flows

List all automation flows

GET

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Klaviyo private API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — the raw API key and Authorization header format never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'track customer purchase event') and Jentic returns matching Klaviyo operations with input schemas, so the agent can call the right endpoint without navigating Klaviyo's 289-endpoint API surface.

Time to first call

Direct Klaviyo integration: 3-5 days for API key management, event schema design, and pagination handling. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Mailchimp Marketing API

Established email marketing platform with broad integrations and simpler automation

Choose Mailchimp when the use case requires broad integration ecosystem compatibility or simpler automation workflows without deep e-commerce behavioral data requirements

Alternative

Brevo Email API

Transactional and marketing email with competitive pricing for high-volume senders

Choose Brevo when the primary need is high-volume transactional email delivery at lower cost without Klaviyo's advanced predictive segmentation

Complementary

SendGrid Mail API

High-volume transactional email delivery with deliverability infrastructure

Use SendGrid alongside Klaviyo when you need dedicated transactional email infrastructure (order confirmations, password resets) separate from marketing campaigns

Complementary

Segment API

Customer data platform that unifies behavioral events from multiple sources into Klaviyo

Use Segment alongside Klaviyo when collecting events from multiple apps, websites, and services that need routing to Klaviyo as a single unified profile

FAQs

Specific to using Klaviyo API API through Jentic.

What authentication does the Klaviyo API use?

The Klaviyo API uses API key authentication via the Authorization header with the format 'Klaviyo-API-Key your-private-api-key'. Through Jentic, your Klaviyo private API key is stored encrypted in the MAXsystem vault. Agents receive scoped access tokens so the raw key never enters the agent context.

Can I track custom events with the Klaviyo API?

Yes. POST to /api/events with a payload containing the event name, customer profile identifier, timestamp, and typed properties (e.g., product_id, value, category). Events feed into segmentation, flow triggers, and predictive analytics within seconds of ingestion.

What are the rate limits for the Klaviyo API?

Klaviyo enforces rate limits per endpoint category. Most endpoints allow 75 requests per second for private API key authentication. Bulk import jobs (/api/profile-bulk-import-jobs, /api/catalog-item-bulk-create-jobs) process asynchronously and are limited by job queue rather than per-second rate. The API returns 429 status codes with a Retry-After header when limits are reached.

How do I create a segment based on purchase behavior through Jentic?

Search Jentic for 'create customer segment by purchase history' to find the segment creation operations. Klaviyo segments are defined by conditions on profile properties and event data. Use the /api/segments endpoint to create segments with conditions referencing the 'Placed Order' event metric, filtering by value, recency, or product category. Install with pip install jentic and execute the search-load-execute flow.

Does the Klaviyo API support both email and SMS campaigns?

Yes. The /api/campaigns endpoint supports creating both email and SMS campaign types. Campaign messages are created via /api/campaign-messages with channel-specific content. Flows can include both email and SMS actions in the same automation sequence, with channel selection per action step.

How do I sync my product catalog with Klaviyo?

Use POST /api/catalog-item-bulk-create-jobs to import items in bulk with fields including title, price, description, URL, and image URL. Variants are synced via /api/catalog-variants. Categories are managed at /api/catalog-categories. Catalog data powers personalized product blocks in emails showing items relevant to each recipient's browsing and purchase history.

Can I retrieve flow performance metrics through the Klaviyo API?

Yes. GET /api/flows returns all flows with their status. Individual flow actions at /api/flow-actions/{id} expose per-step metrics. For aggregate reporting, use the /api/segment-series-reports and /api/segment-values-reports endpoints with flow-related metric filters to get conversion and revenue data.