HubSpot 凭据#

你可以使用这些凭据来认证以下节点：

• HubSpot
• HubSpot Trigger

支持的认证方式#

• App token（应用令牌）：与 HubSpot 节点一起使用。
• Developer API key（开发者 API 密钥）：与 HubSpot Trigger 节点一起使用。
• OAuth2：与 HubSpot 节点一起使用。

API 密钥已弃用 HubSpot 已弃用常规的 API Key 认证方式。该选项在 n8n 中仍然可见，但你应该改用上面列出的认证方式。如果你有正在使用此 API 密钥方式的现有集成，请参考 HubSpot 的 将 API 密钥集成迁移到私有应用 指南，并设置一个应用令牌（app token）。

相关资源#

更多服务信息，请参考 HubSpot 的 API 文档。HubSpot Trigger 节点使用 Webhooks API；有关该服务的更多信息，请参考 HubSpot 的 Webhooks API 文档。

使用 App token（应用令牌）#

要配置此凭据，你需要一个 HubSpot 账户或 HubSpot 开发者 账户，以及：

• 一个 App Token（应用令牌）

要生成应用令牌，请在 HubSpot 中创建一个私有应用（private app）：

1. 在你的 HubSpot 账户中，点击主导航栏中的 设置图标（settings icon）。
2. 在左侧边栏菜单中，进入 集成 > 私有应用（Integrations > Private Apps）。
3. 点击 创建私有应用（Create private app）。
4. 在 基本信息（Basic Info）选项卡中，输入应用的 名称（Name）。
5. 将鼠标悬停在 占位符图标（placeholder logo）上，点击上传图标，上传一张正方形图片作为应用的 Logo。
6. 输入应用的 描述（Description）。
7. 打开 权限范围（Scopes）选项卡，并添加适当的权限范围。请参考 HubSpot 节点所需的权限范围 获取应添加的完整范围列表。
8. 点击 创建应用（Create app）完成创建流程。
9. 在弹出窗口中，查看有关应用访问令牌的信息，然后点击 继续创建（Continue creating）。
10. 应用创建完成后，打开 访问令牌卡片（Access token card），点击 显示令牌（Show token）以查看令牌。
11. 复制该令牌，并将其填入你在 n8n 中的凭证（credential）配置中。

更多信息请参考 HubSpot 私有应用文档。

使用开发者 API 密钥#

要配置此凭据，你需要一个 HubSpot 开发者 账户，以及以下信息：

• 客户端 ID（Client ID）：创建公共应用后生成。
• 客户端密钥（Client Secret）：创建公共应用后生成。
• 开发者 API 密钥（Developer API Key）：从你的开发者应用仪表板中生成。
• 应用 ID（App ID）：创建公共应用后生成。

要创建公共应用并配置凭据，请按以下步骤操作：

1. 登录你的 HubSpot 应用开发者账户。
2. 从主导航栏中选择 Apps（应用）。
3. 点击 获取 HubSpot API 密钥（Get HubSpot API key）。你可能需要点击 显示密钥（Show key）选项。
4. 复制该密钥，并在 n8n 中将其作为 开发者 API 密钥（Developer API Key）输入。
5. 仍在 HubSpot 的 Apps 页面，点击 创建应用（Create app）。
6. 在 应用信息（App Info）选项卡中，填写 应用名称（App name）、描述（Description）、Logo，以及你希望提供的任何支持联系信息。这些信息将对使用该应用的用户可见。
7. 打开 认证（Auth）选项卡。
8. 复制 应用 ID（App ID），并在 n8n 中输入。
9. 复制 客户端 ID（Client ID），并在 n8n 中输入。
10. 复制 客户端密钥（Client Secret），并在 n8n 中输入。
11. 在 权限范围（Scopes）部分，点击 添加新范围（Add new scope）。
12. 将 HubSpot Trigger 节点所需权限范围 中列出的所有范围添加到你的应用中。
13. 点击 更新（Update）。
14. 复制 n8n 的 OAuth 重定向 URL（OAuth Redirect URL），并将其填入 HubSpot 应用的 重定向 URL（Redirect URL）字段中。
15. 点击 创建应用（Create app）完成 HubSpot 应用的创建。

请参考 HubSpot 公共应用文档 获取更详细的说明。

HubSpot Trigger 节点所需的权限范围#

如果你正在创建一个用于 HubSpot Trigger 节点的应用，n8n 建议从以下权限范围（scopes）开始：

HubSpot 旧账户说明 部分 HubSpot 账户无法访问所有权限范围。HubSpot 正在逐步迁移账户。如果你在当前的 HubSpot 开发者账户中找不到全部权限范围，可尝试创建一个新的开发者账户。

使用 OAuth2#

n8n Cloud 用户注意 Cloud 用户无需手动提供连接信息。选择 Connect my account 即可通过浏览器完成授权连接。

如果你是 自托管 n8n，则需要通过创建一个新的公共应用来从头配置 OAuth2：

1. 登录你的 HubSpot 应用开发者账户。
2. 在主导航栏中选择 Apps。
3. 选择 Create app。
4. 在 App Info 标签页中，填写 App name（应用名称）、Description（描述）、Logo（图标），以及你希望提供的任何支持联系信息。这些信息将对使用该应用的用户可见。
5. 打开 Auth 标签页。
6. 复制 App ID 并将其填入 n8n 中。
7. 复制 Client ID 并将其填入 n8n 中。
8. 复制 Client Secret 并将其填入 n8n 中。
9. 在 Scopes 区域，选择 Add new scope（添加新范围）。
10. 将 HubSpot 节点所需权限范围 中列出的所有权限范围添加到你的应用中。
11. 选择 Update（更新）。
12. 复制 n8n 的 OAuth Redirect URL，并将其作为 Redirect URL 填入你的 HubSpot 应用中。
13. 选择 Create app 完成 HubSpot 应用的创建。

请参考 HubSpot 公共应用文档 获取更详细的说明。如果需要深入了解 OAuth 网页流程的工作机制，请查阅 HubSpot OAuth 使用文档。

HubSpot 节点所需的权限范围（Scopes）#

如果你正在创建一个与 HubSpot 节点配合使用的应用，n8n 建议从以下权限范围开始：