Klaviyo

• Email marketing automation — You want an agent to create, schedule, or send Klaviyo campaigns and manage the lists or segments that receive them.
• Customer data management — You need to create, update, merge, or query customer profiles and sync behavioral events from external systems into Klaviyo.
• Flow and lifecycle management — You need to programmatically update flow statuses, inspect flow actions/messages, or tag flows for organization.
• Analytics and reporting — You want to pull metric aggregates or query event histories to build performance summaries or dashboards from Klaviyo data.

• Other third-party platforms — If you need to integrate with apps other than Klaviyo, use the api-gateway skill instead.
• Creating complex flows from scratch via API — Klaviyo limits flow creation through the API; flows are best built in the Klaviyo UI and then managed programmatically.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.