Skip to content

HubSpot 凭据(HubSpot credentials)#

你可以使用以下凭据验证以下节点：

🌐 You can use these credentials to authenticate the following nodes:

支持的身份验证方法(Supported authentication methods)#

  • 服务密钥（推荐）：与 HubSpot 节点一起使用。
  • 开发者 API 密钥：与 HubSpot 触发器 节点一起使用。
  • OAuth2：与 HubSpot 节点一起使用。

API 密钥已弃用

HubSpot 已弃用常规 API 密钥 验证方法。该选项仍然出现在 n8n 中，但你应使用上面列出的验证方法。如果你已有使用此 API 密钥方法的现有集成，请参阅 HubSpot 的 将 API 密钥集成迁移到私有应用 指南并设置服务密钥。

基于UI的私有应用现在已成为传统应用

HubSpot 已将通过 UI 创建的私有应用移至过时状态。如果你正在使用此类应用的私有应用访问令牌，HubSpot 建议改为使用服务密钥。更多信息请参阅 HubSpot 的私有应用文档。

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

🌐 Refer to HubSpot's API documentation for more information about the service. The HubSpot Trigger node uses the Webhooks API; refer to HubSpot's Webhooks API documentation for more information about that service.

使用服务密钥(Using Service Key)#

要配置此凭据，你需要一个拥有超级管理员访问权限或开发者工具访问权限的 HubSpot 账户，并且：

🌐 To configure this credential, you'll need a HubSpot account with super admin access or Developer tools access permission, and:

  • 服务密钥

要生成服务密钥：

🌐 To generate a service key:

  1. 在你的 HubSpot 账户中，前往 开发 > 密钥 > 服务密钥。（你也可以在 设置 > 账户管理 > 集成 > 服务密钥 下找到 服务密钥。）

    HubSpot 开发菜单中的服务密钥页面

  2. 选择 创建服务密钥。

    创建服务密钥表单，包含名称和权限字段

  3. 为你的密钥输入一个描述性的名称。

  4. 选择 添加新权限范围 并选择你的集成所需的权限。有关推荐权限范围的列表，请参阅 HubSpot 节点的必需权限范围。
  5. 选择更新以确认你的范围选择。
  6. 选择创建，然后在对话框中确认。
  7. 点击新的服务密钥名称以导航到其详细信息页面，然后选择 显示 以显示你的密钥。
  8. 使用复制按钮复制密钥值，并将其作为 App Token 粘贴到你的 n8n 凭证中。

公共测试版中的服务密钥

服务密钥目前处于公开测试阶段，可能会发生变化。请参阅HubSpot 的服务密钥文档以获取最新信息。

使用开发者 API 密钥(Using Developer API key)#

要配置此凭证，你需要一个 HubSpot 开发者 账户以及：

🌐 To configure this credential, you'll need a HubSpot developer account and:

  • A 客户端 ID：在你创建公共应用时生成。
  • 一个 客户端密钥：在你创建公共应用后生成。
  • 一个 开发者 API 密钥：从你的开发者应用仪表板生成。
  • 应用 ID：在创建公开应用时生成。

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

🌐 To create the public app and set up the credential:

  1. 登录你的 HubSpot 应用开发者账户。
  2. 从主导航栏中选择 应用。
  3. 选择 获取 HubSpot API 密钥。你可能需要选择 显示密钥 选项。
  4. 复制密钥并将其作为 开发者 API 密钥 输入到 n8n 中。
  5. 仍然在 HubSpot 应用 页面上，选择 创建应用。
  6. 在 应用信息 标签下，添加 应用名称、描述、徽标 以及你希望提供的任何支持联系信息。任何遇到该应用的人都能看到这些内容。
  7. 打开 Auth 标签。
  8. 复制 应用 ID 并将其输入到 n8n 中。
  9. 复制 客户端 ID 并将其输入到 n8n 中。
  10. 复制 客户端密钥 并将其输入到 n8n 中。
  11. 在 Scopes 部分，选择 添加新作用域。
  12. 将HubSpot 触发节点所需范围中列出的所有范围添加到你的应用中。10. 选择更新。11. 复制 n8n 的OAuth 重定向 URL，并在你的 HubSpot 应用中将其输入为重定向 URL。12. 选择创建应用以完成 HubSpot 应用的创建。

有关更详细的说明，请参阅HubSpot 公共应用文档

HubSpot 触发器节点的必填范围(Required scopes for HubSpot Trigger node)#

如果你正在创建一个用于 HubSpot Trigger 节点的应用，n8n 建议从以下权限范围开始：

🌐 If you're creating an app for use with the HubSpot Trigger node, n8n recommends starting with these scopes:

元素 对象 权限 作用域名称
不适用 不适用 不适用 oauth
CRM 公司 读取 crm.objects.companies.read
CRM 公司模式 读取 crm.schemas.companies.read
CRM 联系人 读取 crm.objects.contacts.read
CRM 联系人模式 读取 crm.schemas.contacts.read
CRM 交易 读取 crm.objects.deals.read
CRM 交易模式 读取 crm.schemas.deals.read

使用 OAuth2(Using OAuth2)#

Note for n8n Cloud users

Cloud users don't need to provide connection details. Select Connect my account to connect through your browser.

如果你正在自托管 n8n，你需要通过创建一个新的公开应用从头配置 OAuth2：

🌐 If you're self-hosting n8n, you'll need to configure OAuth2 from scratch by creating a new public app:

  1. 登录你的 HubSpot 应用开发者账户。
  2. 从主导航栏中选择 应用。
  3. 选择 创建应用。
  4. 在 应用信息 标签下，添加 应用名称、描述、徽标 以及你希望提供的任何支持联系信息。任何遇到该应用的人都能看到这些内容。
  5. 打开 Auth 标签。
  6. 复制 应用 ID 并将其输入到 n8n 中。
  7. 复制 客户端 ID 并将其输入到 n8n 中。
  8. 复制 客户端密钥 并将其输入到 n8n 中。
  9. 在 Scopes 部分，选择 添加新作用域。
  10. 将 HubSpot 节点所需的作用域 中列出的所有作用域添加到你的应用中。10. 选择 更新。11. 复制 n8n 的 OAuth 重定向 URL 并将其作为 重定向 URL 输入到你的 HubSpot 应用中。12. 选择 创建应用 以完成 HubSpot 应用的创建。

请参考 HubSpot 公共应用文档 获取更详细的说明。如果你需要了解 OAuth 网络流程中发生的情况，请参考 HubSpot 使用 OAuth 文档。

🌐 Refer to the HubSpot Public Apps documentation for more detailed instructions. If you need more detail on what's happening in the OAuth web flow, refer to the HubSpot Working with OAuth documentation.

HubSpot 节点的必填范围(Required scopes for HubSpot node)#

如果你正在为 HubSpot 节点创建应用，n8n 建议从以下权限范围开始：

🌐 If you're creating an app for use with the HubSpot node, n8n recommends starting with these scopes:

元素 对象 权限 作用域名称
不适用 不适用 不适用 oauth
不适用 不适用 不适用 forms
不适用 不适用 不适用 tickets
CRM 公司 读取
写入		 crm.objects.companies.read
crm.objects.companies.write
CRM 公司模式 读取 crm.schemas.companies.read
CRM 联系人模式 读取 crm.schemas.contacts.read
CRM 联系人 读取
写入		 crm.objects.contacts.read
crm.objects.contacts.write
CRM 交易 读取
写入		 crm.objects.deals.read
crm.objects.deals.write
CRM 交易模式 读取 crm.schemas.deals.read
CRM 拥有者 读取 crm.objects.owners.read
CRM 列表 写入 crm.lists.write