Klaviyo

What It Does

All requests are proxied through `gateway.maton.ai`, which automatically injects your OAuth token — you only need a single `MATON_API_KEY`.

It covers the complete Klaviyo surface area: customer profiles, subscriber lists, dynamic segments, email campaigns, automation flows, behavioral events, performance metrics, email templates, product catalogs, coupons, tags, and webhooks.

The Klaviyo skill provides full access to the Klaviyo API through Maton's managed OAuth gateway, so your AI agent can interact with your Klaviyo account without handling OAuth flows directly.

Key Features

• Managed OAuth via Maton Gateway — Authentication is handled entirely by the Maton gateway — your agent never touches OAuth tokens directly. A single `MATON_API_KEY` authenticates all requests, and the gateway injects the correct Klaviyo OAuth credential automatically. Multiple Klaviyo connections are supported via the `Maton-Connection` header.
• Full Klaviyo API Coverage — Access every major Klaviyo resource: profiles, lists, segments, campaigns, flows, events, metrics, templates, catalogs, coupons, tags, webhooks, and accounts. Both read and write operations (GET, POST, PATCH, DELETE) are supported across all resource types.
• Behavioral Event Tracking — Create individual or bulk events to record customer interactions (e.g., product views, purchases) and associate them with profiles and metrics. Query historical events with flexible date and metric filters.
• Metrics & Aggregate Analytics — Retrieve all available Klaviyo metrics and query aggregate data by time interval, measurement type (count, sum), and date range — enabling automated reporting without leaving your agent workflow.
• Advanced Filtering & Cursor Pagination — Leverage Klaviyo's JSON:API filtering syntax (`equals`, `contains`, `greater-than`, `any`, combined with `and`) and cursor-based pagination to retrieve precisely the records you need at scale.
• Webhook Configuration — Create, update, and delete webhooks to receive real-time Klaviyo event notifications at your endpoint. Manage webhook topics to subscribe only to the events that matter.

Requirements

Create a connection via the API or the Maton control panel and complete the OAuth flow in your browser.

- **Maton API Key** *(required)* — Authenticates all requests to the Maton gateway. Obtain from [maton.ai/settings](https://maton.ai/settings) after creating a free account. - **Klaviyo OAuth Connection** *(required)* — A connected Klaviyo account managed at [ctrl.maton.ai](https://ctrl.maton.ai).

Use Cases

• Automated campaign creation and delivery — An agent receives a brief for a promotional email, creates a campaign in Klaviyo targeting a specific list or segment, attaches a template, estimates recipient count, and triggers the send — all via API without manual UI work.
• Customer profile sync from external systems — When a new user signs up in your app, an agent creates or updates their Klaviyo profile, records a custom event (e.g., "Trial Started"), and adds them to the appropriate onboarding list to trigger a welcome flow.
• Marketing performance reporting — An agent queries metric aggregates for key events (e.g., "Placed Order", "Opened Email") over a date range, formats the results, and delivers a daily or weekly performance summary to a Slack channel or dashboard.
• Coupon code distribution — An agent creates a coupon in Klaviyo, generates unique coupon codes with expiry dates, and associates them with customer profiles or campaigns — automating discount workflows for promotions.