跳到主要内容

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 & URLsRedirect URI
  11. 进入 Secrets 标签页
  12. 复制 Client IDClient Secret 并添加到 n8n 凭据中

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

内部集成与公开集成#

内部集成具有以下特点:

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

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

公开集成具有以下特点:

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

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

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