klaviyo-core-workflow-a

# Klaviyo Core Workflow A -- Profiles, Lists & Subscriptions ## Overview Primary money-path workflow: create/update profiles, manage lists, and subscribe contacts for email and SMS marketing via the `klaviyo-api` SDK. ## Prerequisites - Completed `klaviyo-install-auth` setup - API key with scopes: `profiles:read`, `profiles:write`, `lists:read`, `lists:write` ## Instructions ### Step 1: Create or Update a Profile ```typescript import { ApiKeySession, ProfilesApi, ProfileEnum } from 'klaviyo-api'; const session = new ApiKeySession(process.env.KLAVIYO_PRIVATE_KEY!); const profilesApi = new ProfilesApi(session); // Create a new profile (409 if email already exists) const newProfile = await profilesApi.createProfile({ data: { type: ProfileEnum.Profile, attributes: { email: 'customer@example.com', firstName: 'Jane', lastName: 'Doe', phoneNumber: '+15551234567', location: { city: 'Atlanta', region: 'GA', country: 'US', zip: '30309', }, properties: { plan: 'pro', signupSource: 'website', lifetime_value: 250.00, }, }, }, }); console.log('Profile ID:', newProfile.body.data.id); // Create OR update (upsert) -- preferred for syncing const upserted = await profilesApi.createOrUpdateProfile({ data: { type: ProfileEnum.Profile, attributes: { email: 'customer@example.com', firstName: 'Jane', lastName: 'Doe-Smith', // Updated last name...