SuperAPI AI 工具集

hubspot

编程与开发

查看项目

更新于 10-16 02:36

技能介绍

用途:通过 HubSpot CRM API 操作营销与销售数据,适合在自动化脚本或工具中读写 CRM 记录、管理营销资源。

主要能力: CRM 对象统一采用 /crm/v3/objects/{objectType} 的 CRUD 模式,objectType 可为 contacts、companies、deals、tickets、products、line_items、quotes、tasks、notes、emails、meetings、calls。支持列出、按 ID 获取、创建、更新、删除(移入回收站,90 天内可恢复)、搜索(filterGroups 支持 AND/OR,运算符含 EQ、NEQ、LT、LTE、GT、GTE、CONTAINS_TOKEN、NOT_CONTAINS_TOKEN、HAS_PROPERTY、NOT_HAS_PROPERTY、BETWEEN,最多返回 10,000 条)、批量读取/创建/更新、合并同类型记录。 关联使用 /crm/v4:创建默认或带标签关联、列出、删除、批量读取;常见类型 ID 如 1(联系人→公司)、3(交易→联系人)、5(交易→公司)、27(工单→联系人)、339(工单→公司)。 管道接口 /crm/v3/pipelines/{objectType} 支持列出、获取阶段、创建、更新、新增阶段。属性接口 /crm/v3/properties/{objectType} 支持列出、获取、创建、更新。列表接口 /crm/lists/v3 支持列出、获取、成员查询、创建、增加/移除成员、搜索。 文件接口 /files/v3 支持搜索、按 ID 获取、签名下载 URL、上传、更新、删除、创建文件夹。营销邮件接口 /marketing/v3/emails 支持列出、获取、创建,并可发送事务邮件。表单接口 /marketing/v3/forms 支持列出与获取。会话接口 /conversations/v3 支持列出线程、获取线程、列出消息、发送消息、列出收件箱。设置接口 /account-info/v3/details、/settings/v3 可获取账号信息与用户/团队,/crm/v3/owners 可列出与获取负责人。

使用方式:所有请求在请求头携带 Authorization: Bearer $HUBSPOT_TOKEN。查询或创建对象时务必用 properties 参数指定字段,否则仅返回少量默认字段。列表分页用 limit(最大 100)与 after。

排障:请求失败时可运行 zero doctor check-connector --env-name HUBSPOT_TOKEN,或 zero doctor check-connector --url https://api.hubapi.com/crm/v3/objects/contacts --method GET。

限制:本资料未提供收费、速率限制、认证申请方式与具体 Business Unit 约束等信息,暂未提供。上述内容仅为接口用法整理,实际可用性取决于账号权限与令牌范围。