Agent skill · software engineering · jeremylongshore
klaviyo-install-auth
Install and configure Klaviyo Node.js SDK with API key authentication.
Why this skill is useful
Provides specific installation and configuration steps for the Klaviyo Node.js SDK that the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. Requires klaviyo account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Klaviyo Install & Auth Overview Set up the official klaviyo-api Node.js SDK and configure private API key authentication against Klaviyo's REST API (revision 2024-10-15). The workflow below is the high-level path; the verbatim code for every step lives in the full implementation walkthrough, and copy-paste sequences live in worked examples. Prerequisites Node.js 18+ (or Python 3.10+ for Python SDK) Klaviyo account at https://www.klaviyo.com/ Private API key from Settings > API Keys in Klaviyo dashboard Public API key (for client-side only -- never use in server code) Instructions The full sequence is five steps. The essentials are below; drill into references/implementation.md for the complete code of each step (verify script, revision header, Python setup, scope table). Step 1: Install the Official SDK Important: The npm package is klaviyo-api, not @klaviyo/sdk. The SDK exports per-resource API classes (ProfilesApi, EventsApi, etc.) that each take an ApiKeySession. Step 2: Configure Authentication Store the private key in .env and confirm it is gitignored. Klaviyo uses two key types: Key Type Prefix Use Case Header ---------- -------- ---------- -------- Private API Key pk Server-side REST API Authorization: Klaviyo-API-Key pk Public API Key 6-char Client-side Track/Identify Query param companyid Step 3: Initialize the SDK Steps 4-5: Verify & set the revision header Run a one-time verification against AccountsApi.getAccounts() to prove the key works, and remember every request needs a revision: 2024-10-15 header (the SDK adds it automatically; raw HTTP does not). Full verify script + cURL smoke test: references/implementation.md. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/klaviyo-install-auth