Skip to content

HubSpot 凭据#

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

支持的认证方法#

  • App token：与 HubSpot 节点一起使用。
  • Developer API key：与 HubSpot Trigger 节点一起使用。
  • OAuth2：与 HubSpot 节点一起使用。

API 密钥已弃用

HubSpot 已弃用常规 API Key 认证方法。该选项仍然出现在 n8n 中，但您应该使用上面列出的认证方法。如果您有使用此 API 密钥方法的现有集成，请参考 HubSpot 的将 API 密钥集成迁移到私有应用程序指南并设置应用程序令牌。

相关资源#

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

使用 App token#

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

  • 一个 App Token

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

  1. 在您的 HubSpot 账户中，选择主导航栏中的settings icon。
  2. 在左侧边栏菜单中，转到 Integrations > Private Apps。
  3. 选择 Create private app。
  4. 在 Basic Info 选项卡上，输入您的应用程序的 Name。
  5. 将鼠标悬停在placeholder logo上并选择上传图标以上传将作为您应用程序标志的方形图像。
  6. 为您的应用程序输入 Description。
  7. 打开 Scopes 选项卡并添加适当的范围。参考 HubSpot 节点所需范围获取您应该添加的完整范围列表。
  8. 选择 Create app 完成过程。
  9. 在模态中，查看有关您应用程序访问令牌的信息，然后选择 Continue creating。
  10. 创建应用程序后，打开 Access token card 并选择 Show token 显示令牌。
  11. 复制此令牌并在您的 n8n 凭据中输入。

参考 HubSpot 私有应用程序文档了解更多信息。

使用 Developer API key#

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

  • 一个 Client ID 客户端 ID：创建公共应用程序后生成。
  • 一个 Client Secret 客户端密钥：创建公共应用程序后生成。
  • 一个 Developer API Key：从您的开发者应用程序仪表板生成。
  • 一个 App 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 选项卡上，添加 App name、Description、Logo 和您想要提供的任何支持联系信息。任何遇到应用程序的人都会看到这些。
  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 Redirect URL 并在您的 HubSpot 应用程序中输入为 Redirect URL。
  15. 选择 Create app 完成 HubSpot 应用程序的创建。

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

HubSpot Trigger 节点所需范围#

如果您要创建与 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

HubSpot 旧账户

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

使用 OAuth2#

n8n 云服务用户注意事项

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

如果您正在自托管 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 推荐从这些范围开始：

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

HubSpot 旧账户

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