HubSpot 凭证
您可以使用这些凭据来验证以下节点:
支持的认证方式
- 服务密钥(推荐):与 HubSpot 节点一起使用。
- 开发者 API 密钥:与 HubSpot Trigger 节点一起使用。
- OAuth2:与 HubSpot 节点一起使用。
警告
API key deprecated API 密钥已弃用
HubSpot 已弃用常规 API Key API密钥 身份验证方法。该选项仍然出现在 n8n 中,但您应该使用上面列出的身份验证方法。如果您有使用此 API 密钥方法的现有集成,请参阅 HubSpot 的将 API 密钥集成迁移到私有应用程序 指南并设置服务密钥。
警告
UI based private apps are now legacy 基于 UI 的私人应用程序现已成为传统
HubSpot 已将在 UI 中创建的私人应用程序移至旧状态。如果您使用此类应用程序的私有应用程序访问令牌,HubSpot 建议改用服务密钥。有关更多信息,请参阅HubSpot 的私人应用程序文档。
相关资源
有关该服务的更多信息,请参阅HubSpot 的 API 文档。 HubSpot Trigger 节点使用 Webhooks API;有关该服务的更多信息,请参阅 HubSpot 的 Webhooks API 文档。
使用服务密钥
要配置此凭据,你需要一个拥有 super admin 访问权限或 Developer tools 访问权限的 HubSpot 账户,以及:
- 一个 Service Key
生成 service key:
-
在你的 HubSpot 账户中,进入 Development > Keys > Service Keys。(你也可以在 Settings > Account Management > Integrations > Service Keys 中找到它。)

-
选择 Create service key。

-
为该密钥输入一个有描述性的 Name。
- 选择 Add new scope,并选择你的集成所需的权限。推荐 scopes 列表请参阅HubSpot 节点所需 scopes。
- 选择 Update 以确认 scopes 选择。
- 选择 Create,然后在弹窗中确认。
- 点击新创建的 service key 名称,进入其详情页,再选择 Show 以显示你的 key。
- 使用复制按钮复制 key 值,并将其填入 n8n 凭据中的 App Token。
提示
Service keys in public beta 公开测试版中的服务密钥
服务密钥目前处于公开测试阶段,可能会发生变化。请参阅HubSpot 的服务密钥文档 了解最新信息。
使用开发者 API 密钥
要配置此凭据,您需要一个 HubSpot developer{:target=_blank .external-link} 账户和:
- Client ID 客户端 ID:创建公共应用程序后生成。
- Client Secret 客户端密钥:创建公共应用程序后生成。
- Developer API Key 开发者 API 密钥:从开发者应用程序仪表板生成。
- App ID 应用程序 ID:创建公共应用程序后生成。
要创建公共应用程序并设置凭据:
- 登录您的 HubSpot 应用程序开发者账户。
- 从主导航栏选择应用程序。
- 选择获取 HubSpot API 密钥。您可能需要选择显示密钥选项。
- 复制密钥并在 n8n 中作为开发者 API 密钥输入。
- 仍在 HubSpot 应用程序页面上,选择创建应用程序。
- 在应用程序信息选项卡上,添加应用程序名称、描述、标志以及您想要提供的任何支持联系信息。任何遇到该应用程序的人都会看到这些。
- 打开身份验证选项卡。
- 复制应用程序 ID 并在 n8n 中输入。
- 复制客户端 ID 并在 n8n 中输入。
- 复制客户端密钥并在 n8n 中输入。
- 在范围部分,选择添加新范围。
- 将 HubSpot Trigger 节点所需范围中列出的所有范围添加到您的应用程序。
- 选择更新。
- 复制 n8n OAuth 重定向 URL 并在您的 HubSpot 应用程序中作为重定向 URL 输入。
- 选择创建应用程序以完成 HubSpot 应用程序的创建。
有关更详细的说明,请参考 HubSpot 公共应用程序文档。
HubSpot 触发器节点 所需的范围
如果您要创建与 HubSpot Trigger 节点一起使用的应用程序,n8n 建议从以下范围开始:
| Element 元素 | Object 对象 | Permission 许可 | Scope name 范围名称 |
|---|---|---|---|
| 不适用 | 不适用 | 不适用 | oauth |
| 客户关系管理 | 公司 | 阅读 | crm.objects.companies.read |
| 客户关系管理 | 公司架构 | 阅读 | crm.schemas.companies.read |
| 客户关系管理 | 联系方式 | 阅读 | crm.objects.contacts.read |
| 客户关系管理 | 联系人模式 | 阅读 | crm.schemas.contacts.read |
| 客户关系管理 | 优惠 | 阅读 | crm.objects.deals.read |
| 客户关系管理 | 交易模式 | 阅读 | crm.schemas.deals.read |
Using OAuth2
提示
Note for n8n Cloud users n8n 云用户注意事项
云用户不需要提供连接详细信息。选择 Connect my account 连接我的帐户 通过浏览器进行连接。
如果您是自托管 n8n,则需要通过创建新的公共应用程序从头开始配置 OAuth2:
- 登录您的 HubSpot 应用程序开发者账户。
- 从主导航栏选择应用程序。
- 选择创建应用程序。
- 在应用程序信息选项卡上,添加应用程序名称、描述、标志以及您想要提供的任何支持联系信息。任何遇到该应用程序的人都会看到这些。
- 打开身份验证选项卡。
- 复制应用程序 ID 并在 n8n 中输入。
- 复制客户端 ID 并在 n8n 中输入。
- 复制客户端密钥并在 n8n 中输入。
- 在范围部分,选择添加新范围。
- 将 HubSpot 节点所需范围中列出的所有范围添加到您的应用程序。
- 选择更新。
- 复制 n8n OAuth 重定向 URL 并在您的 HubSpot 应用程序中作为重定向 URL 输入。
- 选择创建应用程序以完成 HubSpot 应用程序的创建。
有关更详细的说明,请参考 HubSpot 公共应用程序文档。如果您需要有关 OAuth Web 流程中发生的事情的更多详细信息,请参考 HubSpot 使用 OAuth 文档。
HubSpot 节点 所需的范围
如果您要创建与 HubSpot 节点一起使用的应用程序,n8n 建议从以下范围开始:
| Element 元素 | Object 对象 | Permission 许可 | Scope name(s) 范围名称 |
|---|---|---|---|
| 不适用 | 不适用 | 不适用 | oauth |
| 不适用 | 不适用 | 不适用 | forms |
| 不适用 | 不适用 | 不适用 | tickets |
| 客户关系管理 | 公司 | 读取 写入 |
crm.objects.companies.read crm.objects.companies.write |
| 客户关系管理 | 公司架构 | 阅读 | crm.schemas.companies.read |
| 客户关系管理 | 联系人模式 | 阅读 | crm.schemas.contacts.read |
| 客户关系管理 | 联系方式 | 读取 写入 |
crm.objects.contacts.read crm.objects.contacts.write |
| 客户关系管理 | 优惠 | 读取 写入 |
crm.objects.deals.read crm.objects.deals.write |
| 客户关系管理 | 交易模式 | 阅读 | crm.schemas.deals.read |
| 客户关系管理 | 业主 | 阅读 | crm.objects.owners.read |
| 客户关系管理 | 列表 | 写 | crm.lists.write |