← Back to Skills Marketplace
17702
Downloads
8
Stars
0
Active Installs
11
Versions
Install in OpenClaw
/install klaviyo
Description
Klaviyo API integration with managed OAuth. Access profiles, lists, segments, campaigns, flows, events, metrics, templates, catalogs, webhooks, tags, coupons, images, forms, reviews, and account settings. Use this skill when users want to manage email marketing, customer data, or integrate with Klaviyo workflows. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user.
Usage Guidance
Install this only if you intend to let an agent access the connected Klaviyo account through Maton. Prefer OAuth, select the narrowest Klaviyo scopes available, use read-only access where possible, and require explicit confirmation before any campaign send, webhook creation, subscription change, bulk import, deletion, or other write operation.
Capability Assessment
Credentials
Network access, Bash, Read, Grep, and Glob are proportionate for a CLI/API integration; the artifact explicitly says local execution from API output is out of scope and treats external API content as untrusted data.
Install Mechanism
Installation is limited to the documented Maton CLI via npm or Homebrew, with an SDK/raw HTTPS fallback described for constrained environments.
Instruction Scope
The skill discloses broad Klaviyo API passthrough authority, including endpoints beyond the listed examples, but it also instructs agents to default to read/list operations and confirm every POST, PUT, PATCH, DELETE, connection creation, and destructive action with the user.
Persistence & Privilege
OAuth tokens or API keys may be stored by the Maton CLI/SDK in local credential storage, which is expected for this integration and clearly disclosed with instructions not to extract, print, persist, or transmit credentials outside api.maton.ai.
Purpose & Capability
The stated purpose is Klaviyo account management, and the documented capabilities match that purpose: profiles, lists, segments, campaigns, flows, events, templates, catalogs, webhooks, subscriptions, and account settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install klaviyo - After installation, invoke the skill by name or use
/klaviyo - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.3
Resolve remaining audit findings: correct the delete-task example object type, align appendix request guidance with GraphQL-only POST, list workspace members and the full Klaviyo surface in the declared scope, and narrow activation wording with explicit exclusions
v1.2.2
Resolve remaining audit findings: state one consistent endpoint policy instead of conflicting scope claims, qualify the local-execution and high-impact wording, note that locale examples are illustrative, and correct app-specific auth, method and upload-path documentation
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.5
- Changed all API endpoints from gateway.maton.ai and ctrl.maton.ai to api.maton.ai for simplified and unified access.
- Updated connection management instructions and examples to use the new api.maton.ai base URL.
- Clarified that all write operations require explicit user approval to enhance security guidance.
- Added a section about security and permissions, specifying access scope and user confirmation for sensitive operations.
- Removed LICENSE.txt file from the package.
v1.0.4
- Updated all examples and documentation references to use the new Klaviyo API revision date header: 2026-01-15 (was 2024-10-15).
- No functional changes detected; this update is documentation-only.
v1.0.3
- Added "clawdbot" metadata section, including an emoji and required environment variable details.
- No functional or documentation changes to skill usage or behavior.
v1.0.2
No user-facing changes detected in version 1.0.2 (no file changes found).
v1.0.1
- Updated SKILL.md examples to use concise Python scripts (via `python <<'EOF'` blocks and `urllib.request`) for all API interactions, replacing previous usage of the `requests` library.
- Added a note to the skill description about using the `api-gateway` skill for third-party apps other than Klaviyo.
- Improved clarity and consistency in code examples and headers.
- Adjusted API call documentation to a more streamlined style, including explicit HTTP methods and sample bash commands.
v1.0.0
Klaviyo Skill v1.0.0
- Initial release with Klaviyo API integration via managed OAuth.
- Provides endpoints for managing profiles, lists, segments, campaigns, flows, events, metrics, templates, catalogs, and webhooks.
- Includes detailed usage instructions, connection management, and API reference with code examples.
- Supports specifying Klaviyo connections and date-based API versioning.
- Requires network access and a valid Maton API key.
Metadata
Frequently Asked Questions
What is klaviyo?
Klaviyo API integration with managed OAuth. Access profiles, lists, segments, campaigns, flows, events, metrics, templates, catalogs, webhooks, tags, coupons, images, forms, reviews, and account settings. Use this skill when users want to manage email marketing, customer data, or integrate with Klaviyo workflows. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user. It is an AI Agent Skill for Claude Code / OpenClaw, with 17702 downloads so far.
How do I install klaviyo?
Run "/install klaviyo" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is klaviyo free?
Yes, klaviyo is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does klaviyo support?
klaviyo is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created klaviyo?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.3.
More Skills