HubSpot 凭据#
您可以使用此凭据验证以下节点：
支持的认证方法#
- 应用令牌：与 HubSpot 节点配合使用。
- 开发者 API 密钥：与 HubSpot Trigger 节点配合使用。
- OAuth2：与 HubSpot 节点配合使用。
API 密钥已弃用
HubSpot 已弃用常规的 API 密钥 认证方法。该选项仍会出现在 n8n 中，但您应改用上面列出的认证方法。如果您现有的集成使用此 API 密钥方法，请参考 HubSpot 的 将 API 密钥集成迁移到私有应用 指南并设置应用令牌。
相关资源#
有关该服务的更多信息，请参阅 HubSpot 的 API 文档。HubSpot Trigger 节点使用 Webhooks API；有关该服务的更多信息，请参阅 HubSpot 的 Webhooks API 文档。
使用应用令牌#
要配置此凭据，您需要拥有一个 HubSpot 账户或 HubSpot 开发者 账户以及：
- 一个 应用令牌
要生成应用令牌，请在 HubSpot 中创建一个私有应用：
- 在您的 HubSpot 账户中，选择主导航栏中的 设置图标。
- 在左侧边栏菜单中，转到 集成 > 私有应用。
- 选择 创建私有应用。
- 在 基本信息 选项卡上，输入您应用的 名称。
- 将鼠标悬停在 占位符徽标 上，然后选择上传图标以上传一个正方形图像，该图像将作为您应用的徽标。
- 为您应用输入 描述。
- 打开 范围 选项卡并添加适当的范围。有关应添加范围的完整列表，请参阅 HubSpot 节点所需范围。
- 选择 创建应用 以完成该过程。
- 在模态窗口中，查看有关您应用访问令牌的信息，然后选择 继续创建。
- 应用创建后，打开 访问令牌卡片 并选择 显示令牌 以显示令牌。
- 复制此令牌并将其输入到您的 n8n 凭据中。
有关更多信息，请参阅 HubSpot 私有应用文档。
使用开发者 API 密钥#
要配置此凭据，您需要拥有一个 HubSpot 开发者 账户以及：
- 客户端 ID：创建公共应用后生成。
- 客户端密钥：创建公共应用后生成。
- 开发者 API 密钥：从您的开发者应用仪表板生成。
- 应用 ID：创建公共应用后生成。
要创建公共应用并设置凭据：
- 登录到您的 HubSpot 应用开发者账户。
- 从主导航栏中选择 应用。
- 选择 获取 HubSpot API 密钥。您可能需要选择 显示密钥 选项。
- 复制该密钥，并在 n8n 中将其作为 开发者 API 密钥 输入。
- 仍在 HubSpot 的 应用 页面上，选择 创建应用。
- 在 应用信息 选项卡上，添加 应用名称、描述、徽标 以及您希望提供的任何支持联系信息。任何遇到该应用的人都会看到这些信息。
- 打开 认证 选项卡。
- 复制 应用 ID 并在 n8n 中输入。
- 复制 客户端 ID 并在 n8n 中输入。
- 复制 客户端密钥 并在 n8n 中输入。
- 在 范围 部分，选择 添加新范围。
- 将 HubSpot Trigger 节点所需范围 中列出的所有范围添加到您的应用中。
- 选择 更新。
- 复制 n8n 的 OAuth 重定向 URL，并将其作为 重定向 URL 输入到您的 HubSpot 应用中。
- 选择 创建应用 以完成 HubSpot 应用的创建。
有关更详细的说明，请参阅 HubSpot 公共应用文档。
HubSpot Trigger 节点所需范围#
如果您正在创建一个与 HubSpot Trigger 节点配合使用的应用，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：
- 登录到您的 HubSpot 应用开发者账户。
- 从主导航栏中选择 应用。
- 选择 创建应用。
- 在 应用信息 选项卡上，添加 应用名称、描述、徽标 以及您希望提供的任何支持联系信息。任何遇到该应用的人都会看到这些信息。
- 打开 认证 选项卡。
- 复制 应用 ID 并在 n8n 中输入。
- 复制 客户端 ID 并在 n8n 中输入。
- 复制 客户端密钥 并在 n8n 中输入。
- 在 范围 部分，选择 添加新范围。
- 将 HubSpot 节点所需范围 中列出的所有范围添加到您的应用中。
- 选择 更新。
- 复制 n8n 的 OAuth 重定向 URL，并将其作为 重定向 URL 输入到您的 HubSpot 应用中。
- 选择 创建应用 以完成 HubSpot 应用的创建。
有关更详细的说明，请参阅 HubSpot 公共应用文档。如果您需要了解 OAuth Web 流程中发生的情况的更多详细信息，请参阅 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 开发者账户中找不到所有范围，请尝试创建一个新的开发者账户。
回到顶部