Skill

klaviyo

Marketing automation, profiles, events, campaigns, flows, segments, and templates.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use klaviyo

Choose if

You're running marketing-automation workflows from an agent loop and want one typed CLI surface for Klaviyo campaign deploys, flow decay analysis, profile dedup, revenue attribution, and launch-readiness QA. Alternative class is calling Klaviyo's REST API directly or using a generic marketing- automation MCP; pick this for typed exit codes, dry-run flags on destructive ops, and integrated UTM-reconciliation reports.

Avoid if

You need a vendor-agnostic email-marketing layer (Mailchimp, Resend, SendGrid) — Klaviyo-only by scope. Also avoid for workloads above 1000 templates per account (hard cap) or when destructive merge/unsubscribe operations must run unattended — those need --yes plus explicit list scope to avoid global unsubscribes.

Risk Flags

  • HIGH data_quality Profile merging is permanent and destroys the source profile in the process. Unsubscribe scope must specify the list explicitly — otherwise "Profiles not in the specified list will be globally unsubscribed." Destructive operations require --yes confirmation.
  • MEDIUM rate_limit Klaviyo enforces per-endpoint burst + steady + daily caps that vary widely: Accounts 1/s + 15/m; Campaigns 10/s + 150/m; Events 350/s + 3500/m; Campaign-value reports 225/day; Flow-series reports 225/day. Exit code 7 on rate limit.
  • MEDIUM scope Template creation hard-caps at 1000 templates per account — creation fails above that. Flow creation + segment update have daily caps in the 15–100/day range.

Cost

Type: Freemium · Free tier: The CLI binary is free to install. Klaviyo's free tier covers up to ~250 profiles + 500 email sends/month; the agent uses a KLAVIYO_API_KEY tied to a workspace.

Hidden costs

  • The CLI is a free wrapper; Klaviyo's underlying plan (free up to 250 profiles; paid above that) governs the actual cost. No additional CLI fees.

Install

Default

npx -y @mvanhorn/printing-press install klaviyo
# Configure Klaviyo private API key:
export KLAVIYO_API_KEY=<pk_xxx>

Setup docs →

Estimated time to first success: ~10 min

Dependencies

Minimum runtime: Node.js 18+ (via npx) or Go 1.26.3+ for source install

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT