跳转至

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. 打开 作用域 选项卡并添加适当的作用域。有关您应该添加的作用域的完整列表，请参阅 HubSpot 节点的所需作用域。
  8. 选择 创建应用程序 完成此过程。
  9. 在模态中，查看有关您应用程序访问令牌的信息，然后选择 继续创建。
  10. 创建应用程序后，打开 访问令牌卡 并选择 显示令牌 以显示令牌。
  11. 复制此令牌并将其输入 n8n 凭证中。

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

使用开发者 API 密钥#

要配置此凭证，您需要一个 HubSpot 开发者 账户和：

  • 一个 客户端 ID：创建公共应用程序后生成。
  • 一个 客户端密钥：创建公共应用程序后生成。
  • 一个 开发者 API 密钥：从您的开发者应用程序仪表板生成。
  • 一个 应用程序 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 触发器节点所需作用域 中列出的所有作用域添加到您的应用程序中。
  13. 选择 更新。
  14. 复制 n8n OAuth 重定向 URL 并在您的 HubSpot 应用程序中将其输入为 重定向 URL。
  15. 选择 创建应用程序 完成创建 HubSpot 应用程序。

有关更详细的说明，请参考 HubSpot 公共应用程序文档。

HubSpot 触发器节点所需的作用域#

如果您要创建与 HubSpot 触发器 节点一起使用的应用程序，n8n 建议从这些作用域开始：

元素 对象 权限 作用域名称
不适用 不适用 不适用 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#

n8n Cloud 用户注意事项

Cloud 用户无需提供连接详情。选择 连接我的账户 通过您的浏览器连接。

如果您 自托管 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 网页流程中发生的更多详细信息，请参考 HubSpot OAuth 使用文档。

HubSpot 节点所需的作用域#

如果您要创建与 HubSpot 节点一起使用的应用程序，n8n 建议从这些作用域开始：

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

此页面是否
💬 微信

🚀 与作者交流

关注公众号
n8n实战笔记公众号
n8n实战笔记
📚 教程 💡 案例 🔧 技巧
添加微信
添加作者微信
1对1 专业指导
⚡ 快答 🎯 定制 🚀 支持

添加后请直说来意， 看到会回复。谢谢