HubSpot 凭据

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

• HubSpot
• HubSpot Trigger

支持的认证方法

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

API key 已弃用

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

相关资源

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

使用 App token

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

• 一个 App Token

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

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

有关更多信息，请参考 HubSpot 私有应用程序文档。

使用 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

HubSpot 旧账户

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

使用 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

HubSpot 旧账户

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