Skip to content

HubSpot 凭证

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

支持的身份验证方法

  • 应用程序令牌:与HubSpot节点一起使用。
  • 开发人员 API 密钥:与HubSpot Trigger节点一起使用。
  • OAuth2:与HubSpot节点一起使用。

API 密钥已弃用

HubSpot 已弃用常规API 密钥身份验证方法。此选项仍显示在 n8n 中,但您应该改用上面列出的身份验证方法。如果您已有使用此 API 密钥方法的集成,请参阅 HubSpot 的“将 API 密钥集成迁移到私有应用”指南并设置应用令牌。

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

使用 App token

要配置此凭证,您需要一个HubSpot帐户或HubSpot 开发者帐户,并且:

  • 应用令牌

要生成应用程序令牌,请在 HubSpot 中创建一个私人应用程序:

  1. 在您的 HubSpot 帐户中,选择主导航栏中的设置图标
  2. 在左侧边栏菜单中,转到集成>私人应用程序
  3. 选择创建私人应用程序
  4. 基本信息选项卡上,输入应用程序的名称
  5. 将鼠标悬停在占位符徽标上,然后选择上传图标以上传方形图像作为应用程序的徽标。
  6. 输入您的应用程序的描述
  7. 打开“范围”选项卡并添加相应的范围。请参阅HubSpot 节点的必需范围,查看您需要添加的范围的完整列表。
  8. 选择“创建应用程序”以完成该过程。
  9. 在模式中,查看有关应用访问令牌的信息,然后选择继续创建
  10. 创建应用程序后,打开访问令牌卡并选择显示令牌以显示令牌。
  11. 复制此令牌并将其输入到您的 n8n 凭证中。

有关更多信息,请参阅HubSpot Private Apps 文档

使用开发者 API 密钥

要配置此凭证,您需要一个HubSpot 开发者帐户以及:

  • 客户端ID :创建公共应用程序后生成。
  • 客户端密钥:创建公共应用程序后生成。
  • 开发人员API 密钥:从您的开发人员应用程序仪表板生成。
  • 应用程序ID :创建公共应用程序后生成。

要创建公共应用程序并设置凭据:

  1. 登录您的HubSpot 应用开发者帐户
  2. 从主导航栏中选择应用程序
  3. 选择获取 HubSpot API 密钥。您可能需要选择显示密钥的选项。
  4. 复制密钥并将其作为开发人员 API 密钥输入 n8n 中。
  5. 仍然在 HubSpot应用程序页面上,选择创建应用程序
  6. “应用信息”选项卡上,添加应用名称描述Logo以及您想要提供的任何支持联系信息。任何使用该应用的人都会看到这些信息。
  7. 打开“身份验证”选项卡。
  8. 复制App ID并将其输入到 n8n 中。
  9. 复制客户端 ID并将其输入到 n8n 中。
  10. 复制客户端密钥并将其输入到 n8n 中。
  11. “范围”部分中,选择“添加新范围”
  12. 将 HubSpot Trigger 节点所需范围中列出的所有范围添加到您的应用程序。
  13. 选择“更新”
  14. 复制 n8n OAuth 重定向 URL并将其作为重定向 URL输入到您的 HubSpot 应用程序中。
  15. 选择创建应用程序以完成 HubSpot 应用程序的创建。

有关更详细的说明,请参阅HubSpot 公共应用程序文档

HubSpot Trigger 节点所需的范围

如果您正在创建与HubSpot Trigger节点一起使用的应用程序,n8n 建议从以下范围开始:

元素 目的 允许 范围名称
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

HubSpot 旧账户

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

使用 OAuth2

n8n Cloud 用户须知

云用户无需提供连接详细信息。选择“连接我的帐户”即可通过浏览器进行连接。

如果您是自托管n8n,则需要通过创建新的公共应用程序从头开始配置 OAuth2:

  1. 登录您的HubSpot 应用开发者帐户
  2. 从主导航栏中选择应用程序
  3. 选择创建应用程序
  4. “应用信息”选项卡上,添加应用名称描述Logo以及您想要提供的任何支持联系信息。任何使用该应用的人都会看到这些信息。
  5. 打开“身份验证”选项卡。
  6. 复制App ID并将其输入到 n8n 中。
  7. 复制客户端 ID并将其输入到 n8n 中。
  8. 复制客户端密钥并将其输入到 n8n 中。
  9. “范围”部分中,选择“添加新范围”
  10. 将 HubSpot 节点所需范围中列出的所有范围添加到您的应用程序。
  11. 选择“更新”
  12. 复制 n8n OAuth 重定向 URL并将其作为重定向 URL输入到您的 HubSpot 应用程序中。
  13. 选择创建应用程序以完成 HubSpot 应用程序的创建。

请参阅HubSpot 公共应用文档,了解更多详细说明。如果您需要更详细地了解 OAuth Web 流程,请参阅HubSpot 使用 OAuth 文档

HubSpot 节点所需的范围

如果您要创建与HubSpot节点一起使用的应用程序,n8n 建议从以下范围开始:

元素 目的 允许 范围名称
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

HubSpot 旧账户

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