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 密钥集成迁移到私有应用 指南，并设置应用令牌。

有关该服务的更多信息，请参阅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 App token)#

要配置此凭证，你需要一个 HubSpot 账户或 HubSpot 开发者 账户，并且：

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

  • 一个 应用令牌

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

🌐 To generate an app token, create a private app in HubSpot:

  1. 在你的 HubSpot 账户中，选择主导航栏上的 设置图标。
  2. 在左侧边栏菜单中，转到 集成 > 私有应用。
  3. 选择 创建私密应用。
  4. 在 基本信息 标签上，输入你应用的 名称。
  5. 将鼠标悬停在占位符logo上，然后选择上传图标，上传一张正方形图片作为你的应用的logo。
  6. 为你的应用输入一个描述。
  7. 打开 Scopes 选项卡并添加适当的权限范围。请参阅 HubSpot 节点所需权限范围 以获取应添加的完整权限范围列表。
  8. 选择 创建应用 以完成此过程。
  9. 在弹出窗口中，查看关于你的应用访问令牌的信息，然后选择 继续创建。10. 应用创建完成后，打开 访问令牌卡片，选择 显示令牌 以显示令牌。11. 复制此令牌并将其输入到你的 n8n 凭证中。

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

🌐 Refer to the HubSpot Private Apps documentation for more information.

使用开发者 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

HubSpot 老账户

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

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

HubSpot 老账户

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