Skip to content

HubSpot 凭据#

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

支持的认证方法#

  • Service key（推荐）：与 HubSpot 节点一起使用。
  • Developer API key：与 HubSpot Trigger 节点一起使用。
  • OAuth2：与 HubSpot 节点一起使用。

API key 已弃用

HubSpot 已弃用常规的 API Key 身份验证方法。该选项仍会出现在 n8n 中，但你应改用上面列出的身份验证方法。如果你已有集成仍在使用这种 API key 方式，请参考 HubSpot 的将 API key 集成迁移到私有应用指南，并改为设置 service key。

基于 UI 创建的私有应用现已归为 legacy

HubSpot 已将通过 UI 创建的私有应用标记为 legacy。如果你当前使用的是这类私有应用的访问 token，HubSpot 建议改用 service key。更多信息请参阅 HubSpot 的 Private Apps 文档。

相关资源#

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

使用 Service Key#

要配置此凭据，你需要一个拥有 super admin 访问权限或 Developer tools 访问权限的 HubSpot 账户，以及：

  • 一个 Service Key

生成 service key：

  1. 在你的 HubSpot 账户中，进入 Development > Keys > Service Keys。（你也可以在 Settings > Account Management > Integrations > Service Keys 中找到它。）

    The Service Keys page in HubSpot's Development menu

  2. 选择 Create service key。

    The Create Service Key form with name and scopes fields

  3. 为该密钥输入一个有描述性的 Name。

  4. 选择 Add new scope，并选择你的集成所需的权限。推荐 scopes 列表请参阅HubSpot 节点所需 scopes。
  5. 选择 Update 以确认 scopes 选择。
  6. 选择 Create，然后在弹窗中确认。
  7. 点击新创建的 service key 名称，进入其详情页，再选择 Show 以显示你的 key。
  8. 使用复制按钮复制 key 值，并将其填入 n8n 凭据中的 App Token。

Service key 仍处于公测阶段

Service key 目前仍处于 public beta，后续可能会变化。最新信息请参阅 HubSpot 的 Service Keys 文档。

使用 Developer API key#

要配置此凭据，您需要一个 HubSpot developer 账户和：

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

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

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

有关更详细的说明，请参考 HubSpot 公共应用程序文档。

Required scopes for HubSpot Trigger node#

如果您正在创建用于 HubSpot Trigger 节点的应用程序，n8n 建议从这些范围开始：

Element Object Permission Scope name
n/a n/a n/a oauth
CRM Companies Read crm.objects.companies.read
CRM Companies schemas Read crm.schemas.companies.read
CRM Contacts Read crm.objects.contacts.read
CRM Contacts schemas Read crm.schemas.contacts.read
CRM Deals Read crm.objects.deals.read
CRM Deals schemas Read crm.schemas.deals.read

使用 OAuth2#

n8n 云服务用户注意事项

云服务用户无需提供连接详细信息。选择连接我的账户通过浏览器进行连接。

如果您正在自托管 n8n，您需要通过创建新的公共应用程序从头配置 OAuth2：

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

有关更详细的说明，请参考 HubSpot 公共应用程序文档。如果您需要有关 OAuth Web 流程中发生的事情的更多详细信息，请参考 HubSpot 使用 OAuth 文档。

Required scopes for HubSpot node#

如果您正在创建用于 HubSpot 节点的应用程序，n8n 建议从这些范围开始：

Element Object Permission Scope name(s)
n/a n/a n/a oauth
n/a n/a n/a forms
n/a n/a n/a tickets
CRM Companies Read
Write		 crm.objects.companies.read
crm.objects.companies.write
CRM Companies schemas Read crm.schemas.companies.read
CRM Contacts schemas Read crm.schemas.contacts.read
CRM Contacts Read
Write		 crm.objects.contacts.read
crm.objects.contacts.write
CRM Deals Read
Write		 crm.objects.deals.read
crm.objects.deals.write
CRM Deals schemas Read crm.schemas.deals.read
CRM Owners Read crm.objects.owners.read
CRM Lists Write crm.lists.write