用途：把联系人及其列表同步到 HubSpot CRM，适合将分析结果（如试用期风险用户邮箱名单）批量上传为 HubSpot 静态列表。
主要能力：基于 HubSpot REST API 的客户端，支持创建静态联系人列表、按邮箱搜索联系人、创建仅有标准属性的联系人、将联系人批量加入列表，并含 CSV 文件上传脚本。认证使用环境变量 HUBSPOT_API_TOKEN（HubSpot 私有应用令牌）。
使用方式：设置 HUBSPOT_API_TOKEN 后，用 HubSpotClient 调用相应方法；也可运行集成脚本，传入 CSV 路径与列表名称，CSV 必须包含 email 列： .venv/bin/python demos/04-trial-to-paid/scripts/hubspot_integration.py path/to/users.csv "List Name Here" 令牌需在 HubSpot 设置中创建私有应用，并启用 crm.lists.read、crm.lists.write、crm.objects.contacts.read、crm.objects.contacts.write 权限范围。
限制与注意事项：创建列表必须提供 objectTypeId 为 0-1（联系人），列表 ID 位于响应嵌套字段 list.listId；加入列表的请求体是简单数组，批量最多 100 条；联系人 ID 按字符串处理；不要传入目标账户中不存在的自定义属性，否则请求会被拒绝；错误通过 HTTPError 捕获并读取响应体。其余功能细节、收费与平台信息暂未提供。