HubSpot 凭证#
您可以使用这些凭证来验证以下节点:
支持的认证方法#
- 应用令牌:与HubSpot节点一起使用。
- 开发者API密钥:与HubSpot触发器节点配合使用。
- OAuth2: 与 HubSpot 节点一起使用。
API密钥已弃用
HubSpot已弃用常规的API密钥认证方式。该选项在n8n中仍然可见,但您应该改用上面列出的认证方法。如果您现有的集成仍在使用此API密钥方式,请参考HubSpot的将API密钥集成迁移到私有应用指南并设置应用令牌。
相关资源#
有关该服务的更多信息,请参阅HubSpot的API文档。HubSpot触发器节点使用Webhooks API;有关该服务的更多信息,请参阅HubSpot的Webhooks API文档。
使用应用令牌#
要配置此凭证,您需要一个HubSpot账户或HubSpot开发者账户以及:
- 一个应用令牌
要生成应用令牌,请在HubSpot中创建一个私有应用:
- 在您的HubSpot账户中,从主导航栏选择设置图标。
- 在左侧边栏菜单中,前往集成 > 私有应用。
- 选择创建私有应用。
- 在基本信息选项卡中,输入您的应用名称。
- 将鼠标悬停在占位符标志上,然后选择上传图标以上传一个方形图像,该图像将作为您应用的标志。
- 为您的应用输入描述。
- 打开Scopes选项卡并添加适当的权限范围。请参考Required scopes for HubSpot node获取需要添加的完整权限范围列表。
- 选择创建应用完成流程。
- 在弹窗中,查看关于您应用访问令牌的信息,然后选择继续创建。
- 应用创建完成后,打开访问令牌卡片并选择显示令牌以查看令牌内容。
- 复制此令牌并在您的n8n凭证中输入它。
更多信息请参考HubSpot 私有应用文档。
使用开发者API密钥#
要配置此凭证,您需要一个HubSpot开发者账户以及:
- 一个客户端ID:创建公共应用时自动生成。
- 一个客户端密钥:创建公共应用时生成。
- 一个开发者API密钥:从您的开发者应用仪表板生成。
- 一个App ID:创建公共应用后自动生成。
创建公共应用并设置凭证:
- 登录您的HubSpot应用开发者账户。
- 从主导航栏中选择应用。
- 选择获取HubSpot API密钥。您可能需要选择显示密钥选项。
- 复制密钥并在n8n中将其输入为开发者API密钥。
- 仍在HubSpot的应用页面,选择创建应用。
- 在应用信息标签页中,添加应用名称、描述、图标以及您想提供的任何支持联系信息。任何遇到该应用的人都会看到这些内容。
- 打开认证标签页。
- 复制App ID并输入到n8n中。
- 复制客户端ID并输入到n8n中。
- 复制客户端密钥并将其输入到n8n中。
- 在作用域部分,选择添加新作用域。
- 将HubSpot Trigger节点所需权限范围中列出的所有权限范围添加到您的应用中。
- 选择更新。
- 复制n8n的OAuth重定向URL并将其作为重定向URL输入到您的HubSpot应用中。
- 选择创建应用以完成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:
- 登录您的HubSpot应用开发者账户。
- 从主导航栏中选择应用。
- 选择创建应用。
- 在应用信息标签页中,添加应用名称、描述、图标以及您想提供的任何支持联系信息。任何遇到该应用的人都会看到这些内容。
- 打开认证选项卡。
- 复制App ID并输入到n8n中。
- 复制客户端ID并输入到n8n中。
- 复制客户端密钥并在n8n中输入。
- 在作用域部分,选择添加新作用域。
- 将HubSpot节点所需权限范围中列出的所有权限范围添加到您的应用中。
- 选择更新。
- 复制n8n的OAuth重定向URL并将其作为重定向URL输入到您的HubSpot应用中。
- 选择创建应用完成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开发者账户中找不到所有权限范围,请尝试创建一个新的开发者账户。