跳到主要内容

Notion 凭据#

您可以使用以下凭据为这些节点进行身份验证：

前置要求#​

创建具有管理员访问权限的 Notion 账户。

支持的认证方式#​

  • API 集成令牌：用于内部集成
  • OAuth2：用于公开集成

集成类型

不确定该使用哪种集成类型？请参阅下方的内部集成与公开集成以获取更多信息。

相关资源#​

有关该服务的更多信息，请参阅 Notion API 文档。

使用 API 集成令牌#​

配置此凭据需要：

  • 内部集成密钥：创建 Notion 集成后生成。

要生成集成密钥，请创建 Notion 集成并从 Secrets 标签页获取集成密钥：

  1. 进入您的 Notion 集成仪表板
  2. 点击 + New integration 按钮
  3. 输入集成名称（例如 n8n integration），可选添加徽标
  4. 点击 Submit 创建集成
  5. 打开 Capabilities 标签页，勾选以下权限：
    • 读取内容
    • 更新内容
    • 插入内容
    • 不含邮箱地址的用户信息
  6. 务必点击 Save changes
  7. 选择 Secrets 标签页
  8. 复制 Internal Integration Token 并添加到 n8n 的 Internal Integration Secret 中

有关服务认证的更多信息，请参阅内部集成认证流程设置文档

与集成共享 Notion 页面#​

要使集成与 Notion 交互，必须为集成授予页面权限：

  1. 访问 Notion 工作区中的页面
  2. 点击页面右上角的三点菜单
  3. 在 Connections 中选择 Connect to
  4. 使用搜索栏在下拉列表中找到并选择您的集成

成功共享至少一个页面后即可开始发起 API 请求。若未共享页面，所有 API 请求都将返回错误。

更多信息请参阅集成权限说明

使用 OAuth2#​

配置此凭据需要：

  • 客户端 ID：配置公开集成后生成
  • 客户端密钥：配置公开集成后生成

您需要创建 Notion 集成并设置为公开分发：

  1. 进入您的 Notion 集成仪表板
  2. 点击 + New integration 按钮
  3. 输入集成名称（例如 n8n integration），可选添加徽标
  4. 点击 Submit 创建集成
  5. 打开 Capabilities 标签页，勾选以下权限：
    • 读取内容
    • 更新内容
    • 插入内容
    • 不含邮箱地址的用户信息
  6. 点击 Save changes
  7. 进入 Distribution 标签页
  8. 开启 Do you want to make this integration public? 控制开关
  9. 在 Organization Information 部分填写公司名称和网站
  10. 复制 n8n OAuth Redirect URL 并添加到 Notion 集成 OAuth Domain & URLs 的 Redirect URI 中
  11. 进入 Secrets 标签页
  12. 复制 Client ID 和 Client Secret 并添加到 n8n 凭据中

有关服务认证的更多信息，请参阅 Notion 的公开集成认证流程设置指南

内部集成与公开集成#​

内部集成具有以下特点：

  • 专用于单个工作区
  • 仅限该工作区成员访问
  • 适合定制化工作区增强功能

内部集成采用更简化的认证流程（集成密钥），发布前无需经过安全审核。

公开集成具有以下特点：

  • 可在多个无关的 Notion 工作区中使用
  • 所有 Notion 用户均可访问（无论其工作区）
  • 适合满足广泛使用场景

公开集成采用 OAuth 2.0 协议进行认证，发布前需通过 Notion 安全审核。

关于两种集成类型的详细对比，请参阅 Notion 的内部集成与公开集成文档