klaviyo-integration_skill

Overview

This skill integrates Klaviyo through the Membrane platform to manage Persons, Campaigns, Flows, Events, Lists, Segments, and Templates. It streamlines common marketing automation tasks and exposes both pre-built actions and a proxy for raw API requests. Use it when you need to read or write Klaviyo data without handling auth or pagination yourself.

How this skill works

The skill runs Klaviyo actions via the Membrane CLI or API connector: Membrane handles OAuth, credential refresh, pagination, and error handling. Discover available actions with action-list commands, run them directly, or use Membrane’s proxy to call any Klaviyo REST endpoint with injected authentication headers. Input schemas are returned by Membrane so you can supply the right parameters when executing actions.

When to use it

• Sync customer profiles or list members between systems
• Trigger or inspect email/SMS campaigns and flows programmatically
• Record or query custom events and behavioral data in Klaviyo
• Run one-off API requests to endpoints not covered by pre-built actions
• Avoid storing or rotating Klaviyo API keys locally

Best practices

• Use Membrane’s pre-built actions first — they handle pagination, mapping, and common edge cases
• Create a Membrane connection instead of sharing API keys; let Membrane manage auth lifecycle
• Run action discovery (action list) to learn available inputs before calling an action
• Prefer the Membrane proxy for uncommon endpoints, but validate request/response schemas
• Test on small datasets and use query flags to limit results when exploring data

Example use cases

• Add or update a customer profile and subscribe them to a list when they register
• Trigger a campaign or flow based on an external event (purchase, signup, churn signal)
• Fetch segment members for targeted analytics or export
• Record custom events from your app into Klaviyo for personalization and segmentation
• Execute a custom GET/POST to a Klaviyo endpoint via Membrane when no action exists