用途：通过统一的 REST 路径操作 HubSpot CRM 记录。所有对象类型都在 https://api.hubapi.com/crm/v3/objects/{objectType} 下，支持相同的列表、搜索、批量和关联操作。
主要能力：列出、读取、创建、更新、归档记录；按唯一属性读取与更新；批量读/建/改/upsert；搜索（filterGroups/排序/分页）；列出与创建关联（v4）；查询属性目录与管道阶段。对象类型可用名称（contacts、companies、deals、tickets）或数字 objectTypeId（0-1、0-2、0-3、0-5），自定义对象为 2-<n> 或 p_<name>。
必要用法：认证由运行环境注入，不要创建或刷新令牌。读取属性需显式传入 properties= 逗号列表，否则只返回少量默认字段。创建时注意去重键：联系人按 email、公司按 domain，交易与工单无去重。列表与搜索使用游标分页（paging.next.after）；列表 limit 上限 100，搜索上限 200 且单次查询最多 10000 条结果。批处理最多 100 条记录。
限制与错误：错误返回 {"status":"error","message":...,"category":...}，无 .results，需先判断 .status。400 属性/枚举错误，401/403 分别表示凭据缺失或缺少 scope，404 记录不存在，409 唯一键冲突，429 需按响应头间隔重试，5xx 可退避重试。速率限制：免费/入门版每 10 秒 100 请求，专业/企业版 190 请求；搜索端点每账号每秒 5 请求且不返回限流头。v3/v4 路径目前仍可用，v4 将于 2027-03-30 停止支持，暂无需迁移。日期路径版本正在推出。更多端点见 references/api.md。