About

Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/klaviyo-install-auth/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill klaviyo-install-auth. Copyright stays with the author (MIT).

Klaviyo Install & Auth

Name: klaviyo-install-auth
Author: jeremylongshore

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

# Node.js (official SDK -- NOT @klaviyo/sdk, that's deprecated)
npm install klaviyo-api

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 `company_id`

Step 3: Initialize the SDK

// src/klaviyo/client.ts
import { ApiKeySession, ProfilesApi, EventsApi, ListsApi } from 'klaviyo-api';

const session = new ApiKeySession(process.env.KLAVIYO_PRIVATE_KEY!);

export const profilesApi = new ProfilesApi(session);
export const eventsApi = new EventsApi(session);
export const listsApi = new ListsApi(session);

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.

Output

klaviyo-api package installed in node_modules
.env file with KLAVIYO_PRIVATE_KEY set
Verified API connection with account name printed
Per-resource API clients ready for import

Error Handling

Error	Status	Cause	Solution
`Authentication failed`	401	Invalid or expired private key	Regenerate key at Settings > API Keys
`Forbidden`	403	Key missing required scopes	Create key with appropriate scopes (e.g., `profiles:read`)
`Rate limited`	429	Exceeded 75 req/s burst or 700 req/min steady	Honor `Retry-After` header; see `klaviyo-rate-limits`
`MODULE_NOT_FOUND`	N/A	Wrong package name	Use `klaviyo-api`, not `@klaviyo/sdk`
`ENOTFOUND a.klaviyo.com`	N/A	DNS/network failure	Check internet connectivity, firewall rules

Examples

Four copy-paste sequences (fresh Node project, key verification, Python with retry tuning, raw-HTTP smoke test) are in references/examples.md. The fastest sanity check — confirm a key from a shell before writing any code:

curl -X GET "https://a.klaviyo.com/api/profiles/" \
  -H "Authorization: Klaviyo-API-Key pk_***" \
  -H "revision: 2024-10-15" \
  -H "Accept: application/vnd.api+json"

A 200 with a JSON data array means the key and revision header are valid; a 401 means the key is wrong; a 403 means it lacks the profiles:read scope.

Resources

Full implementation walkthrough — verbatim code for all 5 steps, Python setup, and the API scopes table
Worked examples — four end-to-end copy-paste sequences
Klaviyo API Reference
Authentication Guide
klaviyo-api npm
klaviyo-api-node GitHub
Klaviyo Status

Next Steps

After successful auth, proceed to the klaviyo-hello-world skill for your first profile + event API call, then klaviyo-rate-limits to harden request handling against the 75 req/s burst ceiling.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-klaviyo-install-auth/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-klaviyo-install-auth.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-klaviyo-install-auth",
  "kind": "skill",
  "name": "klaviyo-install-auth",
  "description": "Install and configure Klaviyo Node.js SDK with API key authentication. Use when setting up a new Klaviyo integration, configuring API keys, or initializing the klaviyo-api package in your project. Trigger with phrases like \"install klaviyo\", \"setup klaviyo\", \"klaviyo auth\", \"configure klaviyo API key\", \"klaviyo SDK setup\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "saas",
      "klaviyo",
      "email-marketing",
      "cdp",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Install and configure Klaviyo Node.js SDK with API key authentication. Use when setting up a new Klaviyo integration, configuring API keys, or initializing the klaviyo-api package in your project. Trigger with phrases like \"install klaviyo\", \"setup klaviyo\", \"klaviyo auth\", \"configure klaviyo API key\", \"klaviyo SDK setup\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "skills/.curated/klaviyo-install-auth/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/skills/.curated/klaviyo-install-auth/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/skills/.curated/klaviyo-install-auth/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Write,",
      "Edit,",
      "Bash(npm:*),",
      "Bash(pnpm:*),",
      "Bash(pip:*),",
      "Grep"
    ],
    "license": "MIT"
  },
  "instructions": "# Klaviyo Install & Auth\n\n## Overview\n\nSet 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](references/implementation.md), and copy-paste sequences live in [worked examples](references/examples.md).\n\n## Prerequisites\n\n- Node.js 18+ (or Python 3.10+ for Python SDK)\n- Klaviyo account at https://www.klaviyo.com/\n- Private API key from **Settings > API Keys** in Klaviyo dashboard\n- Public",
  "cost": {
    "context_tokens": 1146
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-klaviyo-install-auth/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.