Klaviyo API

Name: Klaviyo 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.

Install Jentic One Beta

Connect the Klaviyo API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Klaviyo API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Klaviyo 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

GET STARTED

Start building with Klaviyo API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Klaviyo 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 Jentic?

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

Credential isolation

Your Klaviyo API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'record a customer event' or 'read a marketing segment', and Jentic returns the matching Klaviyo operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using Klaviyo 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 your Jentic One instance. 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.

Can I limit what my agent is allowed to do with the Klaviyo API?

Yes. Jentic One is self-hosted by you, so your own rules decide which Klaviyo operations and credentials the agent may use. Because most Klaviyo writes carry the profile, event, or campaign in the request body rather than pinning a resource in the URL path, you scope by operation: grant only the operations the agent needs, such as reading profiles and segments or recording events via /api/events. You can leave higher-impact operations like campaign sends out of scope unless you explicitly add them.

Klaviyo API

Connect the Klaviyo API to your agent

Capabilities

Start building with Klaviyo API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs