Customer.io Install & Auth

Overview

Set up Customer.io SDK and configure authentication credentials for email, push, SMS, and in-app messaging automation.

Prerequisites

• Node.js 18+ or Python 3.10+

• Package manager (npm, pnpm, or pip)

• Customer.io account with API access

• Site ID and API Key from Customer.io dashboard

Instructions

Step 1: Install SDK

Step 2: Configure Authentication

Step 3: Verify Connection

For detailed implementation code and configurations, load the reference guide: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)

Output

• Installed SDK package in node_modules or site-packages

• Environment variables or .env file with Site ID and API Key

• Successful connection verification output

Error Handling

Error Cause Solution

Invalid API Key Incorrect or expired key Verify key in Customer.io Settings > API Credentials

Invalid Site ID Wrong site identifier Check Site ID in Customer.io Settings

401 Unauthorized Authentication failed Ensure both Site ID and API Key are correct

Network Error Firewall blocking Ensure outbound HTTPS to track.customer.io allowed

Module Not Found Installation failed Run npm install or pip install again

Examples

TypeScript Setup

Python Setup

Resources

• Customer.io Documentation

• Track API Reference

• Customer.io Status

Next Steps

After successful auth, proceed to customerio-hello-world for your first API call.