klaviyo-api

What This Skill Does

The klaviyo-api skill provides a seamless, authenticated gateway to interact with the Klaviyo platform directly through OpenClaw. It abstracts the complexities of OAuth 2.0 by leveraging the Maton gateway, allowing you to programmatically manage customer profiles, email lists, segments, marketing campaigns, and transactional flows. By utilizing this skill, developers and marketers can automate data synchronization, trigger events, or extract performance metrics without manual authentication overhead. It serves as an essential bridge between your automated workflows and your customer engagement data stored within Klaviyo.

Installation

To integrate this skill into your environment, use the OpenClaw installer command via your terminal: clawhub install openclaw/skills/skills/zaycv/klaviyoapi. Once installed, ensure you have a valid account at maton.ai and generate your API key from the settings dashboard. Export this key as an environment variable by running export MATON_API_KEY="YOUR_API_KEY". Manage your active connections and OAuth sessions at the Maton control panel to ensure your permissions remain valid.

Use Cases

• Automated Data Sync: Sync customer purchase data from external databases into Klaviyo profiles.
• List Management: Automatically add or remove subscribers from specific lists based on real-time activity.
• Campaign Analytics: Fetch performance metrics for ongoing email campaigns and save the data to a local analysis log.
• Dynamic Flow Control: Trigger custom events in Klaviyo based on external triggers or specific user behaviors detected by other agents.
• Template Management: Fetch and update email templates programmatically for consistent branding across large-scale deployments.

Example Prompts

1. "Fetch all profiles in the 'Newsletter' list and list their email addresses for me."
2. "Create a new event in Klaviyo for user [email protected] indicating they have completed the onboarding sequence."
3. "Summarize the open and click-through rates for the last three email campaigns sent this month."

Tips & Limitations

Always include the revision header in your requests to ensure compatibility with Klaviyo's evolving API. Remember that the skill proxies requests to a.klaviyo.com; verify your API paths against the official Klaviyo documentation. For operations involving PII (Personally Identifiable Information), ensure your local environment handling the data is secure. If you require integration with platforms other than Klaviyo, use the designated api-gateway skill instead of modifying this module.