用途：这是 Klaviyo 的主要变现路径工作流，用于创建或更新档案、管理列表，并为邮件与短信营销订阅联系人。
主要能力：六步流程——1) 创建或更新档案，优先用 createOrUpdateProfile（upsert）避免重复邮箱返回 409；2) 用 listsApi.createList 创建列表并取得 listId，getLists() 枚举现有列表；3) 用 createListRelationships 添加列表成员（不授予营销同意）；4) 用 subscribeProfiles 记录邮件/短信营销同意及 consentTimestamp；5) 用 getProfiles({ filter, sort }) 按 equals、greater-than、contains 查询细分；6) 批量导入时每 100 条一批以控制速率。
使用方式：所有调用通过基于私钥的 ApiKeySession 认证，示例：import { ApiKeySession, ProfilesApi, ListsApi } from 'klaviyo-api'; const session = new ApiKeySession(process.env.KLAVIYO_PRIVATE_KEY!); 前置条件为已完成 klaviyo-install-auth 使 KLAVIYO_PRIVATE_KEY 可用，私钥需具备 profiles:read、profiles:write、lists:read、lists:write 权限，并安装 klaviyo-api（npm install klaviyo-api），项目配置 Node.js 与 TypeScript。
适用场景：新注册同步到订阅列表并带同意、按自定义属性细分客户并导出邮箱、批量导入客户 CSV。
限制与错误处理：重复档案 409 用 upsert；电话格式错误 400 需用 E.164（如 +15551234567）；列表未找到 404 用 getLists() 核对；缺少同意 400 必须带 consentTimestamp；速率限制 429（超过 75 请求/秒突发）参见 klaviyo-rate-limits。完整代码见 references/implementation.md，端到端示例见 references/examples.md。事件跟踪与活动触发见 klaviyo-core-workflow-b。