跳至内容

HubSpot 凭证#

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

支持的认证方法#

  • 应用令牌:与HubSpot节点一起使用。
  • 开发者API密钥:与HubSpot触发器节点配合使用。
  • OAuth2: 与 HubSpot 节点一起使用。

API密钥已弃用

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

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

使用应用令牌#

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

  • 一个应用令牌

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

  1. 在您的HubSpot账户中,从主导航栏选择设置图标
  2. 在左侧边栏菜单中,前往集成 > 私有应用
  3. 选择创建私有应用
  4. 基本信息选项卡中,输入您的应用名称
  5. 将鼠标悬停在占位符标志上,然后选择上传图标以上传一个方形图像,该图像将作为您应用的标志。
  6. 为您的应用输入描述
  7. 打开Scopes选项卡并添加适当的权限范围。请参考Required scopes for HubSpot node获取需要添加的完整权限范围列表。
  8. 选择创建应用完成流程。
  9. 在弹窗中,查看关于您应用访问令牌的信息,然后选择继续创建
  10. 应用创建完成后,打开访问令牌卡片并选择显示令牌以查看令牌内容。
  11. 复制此令牌并在您的n8n凭证中输入它。

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

使用开发者API密钥#

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

  • 一个客户端ID:创建公共应用时自动生成。
  • 一个客户端密钥:创建公共应用时生成。
  • 一个开发者API密钥:从您的开发者应用仪表板生成。
  • 一个App ID:创建公共应用后自动生成。

创建公共应用并设置凭证:

  1. 登录您的HubSpot应用开发者账户
  2. 从主导航栏中选择应用
  3. 选择获取HubSpot API密钥。您可能需要选择显示密钥选项。
  4. 复制密钥并在n8n中将其输入为开发者API密钥
  5. 仍在HubSpot的应用页面,选择创建应用
  6. 应用信息标签页中,添加应用名称描述图标以及您想提供的任何支持联系信息。任何遇到该应用的人都会看到这些内容。
  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触发器节点所需的权限范围#

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

元素 对象 权限 作用域名称
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. 从主导航栏中选择应用
  3. 选择创建应用
  4. 应用信息标签页中,添加应用名称描述图标以及您想提供的任何支持联系信息。任何遇到该应用的人都会看到这些内容。
  5. 打开认证选项卡。
  6. 复制App ID并输入到n8n中。
  7. 复制客户端ID并输入到n8n中。
  8. 复制客户端密钥并在n8n中输入。
  9. 作用域部分,选择添加新作用域
  10. HubSpot节点所需权限范围中列出的所有权限范围添加到您的应用中。
  11. 选择更新
  12. 复制n8n的OAuth重定向URL并将其作为重定向URL输入到您的HubSpot应用中。
  13. 选择创建应用完成HubSpot应用的创建。

请参阅HubSpot公共应用文档获取更详细的说明。如需了解OAuth网页流程中的具体操作,请参考HubSpot OAuth工作文档

HubSpot节点所需的权限范围#

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

元素 对象 权限 作用域名称
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开发者账户中找不到所有权限范围,请尝试创建一个新的开发者账户。

优云智算