Agent skill · software engineering · jeremylongshore
klaviyo-hello-world
Create a minimal working Klaviyo example with real API calls.
Why this skill is useful
Provides a complete runnable script for integrating with the Klaviyo API, including specific API calls and error handling that the AI wouldn't generate on its own.
What it needs
Requires klaviyo-api, tsx 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 Hello World Overview Minimal working example: create a profile, track an event, and query the result using the klaviyo-api Node.js SDK against a.klaviyo.com/api/. This is the smoke test that proves your API key, SDK install, and network path all work end-to-end before you build anything real. Prerequisites Completed the klaviyo-install-auth setup so credentials are in place. KLAVIYOPRIVATEKEY exported in your environment (a private API key with Profiles and Events scopes). klaviyo-api installed in the project (npm install klaviyo-api). tsx available to run the TypeScript file (npx tsx …). Instructions Write the code into a single hello-klaviyo.ts file, then run it with npx tsx hello-klaviyo.ts. The full script performs four things in order: 1. Create a profile — profilesApi.createProfile(...) with a JSON:API payload. The essential skeleton: 2. Track an event — eventsApi.createEvent(...) with a metric (created on first use) linked to the profile by email. 3. Retrieve the profile — profilesApi.getProfiles({ filter: '...' }) to confirm the write landed. 4. Run the combined script — npx tsx hello-klaviyo.ts. For the complete step-by-step code (all payloads with camelCase and JSON:API detail), see the full walkthrough. For the single combined runnable script and variations, see worked examples. Output Running the combined script prints one line per operation. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/klaviyo-hello-world--7157a4