klaviyo-install-auth

# 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`). ## 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 ### Step 1: Install the Official SDK ```bash # Node.js (official SDK -- NOT @klaviyo/sdk, that's deprecated) npm install klaviyo-api # Python pip 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 ```bash # .env (NEVER commit to git) KLAVIYO_PRIVATE_KEY=pk_*********************************** KLAVIYO_PUBLIC_KEY=UXxxXx # Only for client-side endpoints # .gitignore -- ensure secrets are excluded echo '.env' >> .gitignore echo '.env.local' >> .gitignore ``` 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 ```typescript // src/klaviyo/client.ts import { ApiKeySession, ProfilesApi...