customerio-install-auth

# Customer.io Install & Auth ## Overview Set up the `customerio-node` SDK and configure authentication for Customer.io's two API surfaces: the **Track API** (identify users, track events) and the **App API** (transactional messages, broadcasts, data queries). ## Prerequisites - Node.js 18+ with npm/pnpm - Customer.io account at https://fly.customer.io - **Site ID** + **Track API Key** from Settings > Workspace Settings > API & Webhook Credentials - **App API Key** (bearer token) from the same page — needed for transactional messages and broadcasts ## Two API Keys, Two Clients | Client | Auth Method | Key Source | Use For | |--------|-------------|-----------|---------| | `TrackClient` | Basic Auth (Site ID + API Key) | Track API credentials | `identify()`, `track()`, `trackAnonymous()`, `suppress()`, `destroy()` | | `APIClient` | Bearer Token (App API Key) | App API credentials | `sendEmail()`, `sendPush()`, `triggerBroadcast()` | ## Instructions ### Step 1: Install the SDK ```bash npm install customerio-node ``` The package exports `TrackClient`, `APIClient`, `RegionUS`, `RegionEU`, `SendEmailRequest`, and `SendPushRequest`. ### Step 2: Configure Environment Variables ```bash # .env — NEVER commit this file CUSTOMERIO_SITE_ID=your-site-id-here CUSTOMERIO_TRACK_API_KEY=your-track-api-key-here CUSTOMERIO_APP_API_KEY=your-app-api-key-here CUSTOMERIO_REGION=us # "us" or "eu" ``` Add `.env` to `.gitignore` if not already there. ### Step 3: Create the Track ...