Skip to content

HubSpot 认证凭据#

您可以使用以下凭据来验证这些节点：

支持的认证方式#

API 密钥已弃用

HubSpot 已弃用常规的 API 密钥 认证方式。该选项仍会显示在 n8n 中，但您应该改用上述认证方式。如果您现有的集成使用了这种 API 密钥方式，请参考 HubSpot 的 将 API 密钥集成迁移到私有应用 指南并设置应用令牌。

相关资源#

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

使用应用令牌#

要配置此凭据，您需要拥有 HubSpot 账户或 HubSpot 开发者 账户，并准备以下内容：

  • 一个 应用令牌

要生成应用令牌，请在 HubSpot 中创建私有应用：

  1. 在您的 HubSpot 账户中，点击主导航栏中的 设置图标。
  2. 在左侧边栏菜单中，转到 集成 > 私有应用。
  3. 选择 创建私有应用。
  4. 在 基本信息 标签页中，输入您的应用 名称。
  5. 将鼠标悬停在 占位徽标 上，选择上传图标来上传一个方形图片作为应用徽标。
  6. 为您的应用输入 描述。
  7. 打开 权限范围 标签页并添加适当的权限范围。请参考 HubSpot 节点所需权限范围 获取应添加的完整权限列表。
  8. 选择 创建应用 完成此过程。
  9. 在弹出窗口中，查看关于您应用访问令牌的信息，然后选择 继续创建。
  10. 应用创建完成后，打开 访问令牌卡片 并选择 显示令牌 以查看令牌。
  11. 复制此令牌并输入到您的 n8n 凭据中。

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

使用开发者 API 密钥#

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

  • 客户端 ID：创建公共应用后生成
  • 客户端密钥：创建公共应用后生成
  • 开发者 API 密钥：从开发者应用仪表板生成
  • 应用 ID：创建公共应用后生成

创建公共应用并设置凭据的步骤如下：

  1. 登录您的 HubSpot 应用开发者账户
  2. 从主导航栏选择 Apps
  3. 选择 Get HubSpot API key。您可能需要选择 Show key 选项
  4. 复制该密钥并在 n8n 中作为 Developer API Key 输入
  5. 仍在 HubSpot 的 Apps 页面，选择 Create app
  6. 在 App Info 标签页，添加 应用名称、描述、徽标以及您想提供的任何支持联系信息。这些信息会被使用该应用的用户看到
  7. 打开 Auth 标签页
  8. 复制 App ID 并在 n8n 中输入
  9. 复制 Client ID 并在 n8n 中输入
  10. 复制 Client Secret 并在 n8n 中输入
  11. 在 Scopes 部分，选择 Add new scope
  12. 将 HubSpot Trigger 节点所需权限 中列出的所有权限范围添加到您的应用
  13. 选择 Update
  14. 复制 n8n 的 OAuth 重定向 URL 并在您的 HubSpot 应用中作为 Redirect URL 输入
  15. 选择 Create app 完成 HubSpot 应用的创建

更多详细说明请参考 HubSpot 公共应用文档

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

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

元素 对象 权限 范围名称
不适用 不适用 不适用 oauth
CRM 公司 读取 crm.objects.companies.read
CRM 公司架构 读取 crm.schemas.companies.read
CRM 联系人 读取 crm.objects.contacts.read
CRM 联系人架构 读取 crm.schemas.contacts.read
CRM 交易 读取 crm.objects.deals.read
CRM 交易架构 读取 crm.schemas.deals.read

HubSpot 旧账户

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

使用 OAuth2 认证#

/// 注意 | 针对 n8n Cloud 用户的提示 云版本用户无需提供连接详细信息。选择 连接我的账户 即可通过浏览器完成连接。 ///

如果您是自托管 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 并粘贴到 HubSpot 应用的 Redirect URL 字段中。
  13. 选择 Create app 完成 HubSpot 应用的创建。

如需更详细的指导，请参考 HubSpot 公共应用文档。如需了解 OAuth 网页流程的更多细节，请参阅 HubSpot OAuth 工作文档。

HubSpot 节点所需的权限范围#

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

元素 对象 权限 范围名称
不适用 不适用 不适用 oauth
不适用 不适用 不适用 forms
不适用 不适用 不适用 tickets
CRM 公司 读取
写入		 crm.objects.companies.read
crm.objects.companies.write
CRM 公司架构 读取 crm.schemas.companies.read
CRM 联系人架构 读取 crm.schemas.contacts.read
CRM 联系人 读取
写入		 crm.objects.contacts.read
crm.objects.contacts.write
CRM 交易 读取
写入		 crm.objects.deals.read
crm.objects.deals.write
CRM 交易架构 读取 crm.schemas.deals.read
CRM 所有者 读取 crm.objects.owners.read
CRM 列表 写入 crm.lists.write

HubSpot 旧账户

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