Notion 凭据#

你可以使用这些凭据来认证以下节点：

• Notion
• Notion Trigger

前提条件#

创建一个具有管理员权限的 Notion 账户。

支持的认证方式#

• API 集成令牌（API integration token）：用于内部集成。
• OAuth2：用于公开集成（public integrations）。

集成类型 不确定该使用哪种集成类型？请参考下方的 内部集成 vs. 公开集成（Internal vs. public integrations） 获取更多信息。

相关资源#

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

使用 API 集成令牌#

要配置此凭据，你需要：

• 一个 内部集成密钥（Internal Integration Secret）：在创建 Notion 集成后生成。

要生成集成密钥，请创建一个 Notion 集成，然后从 Secrets（密钥）选项卡中复制集成密钥：

1. 进入你的 Notion 集成仪表板。
2. 点击 + New integration（新建集成）按钮。
3. 为你的集成输入一个 名称（Name），例如 n8n integration。如有需要，可添加一个 Logo（图标）。
4. 点击 Submit（提交）以创建集成。
5. 打开 Capabilities（功能权限）选项卡，选择以下权限：
   • Read content（读取内容）
   • Update content（更新内容）
   • Insert content（插入内容）
   • User information without email addresses（用户信息，不含邮箱地址）
6. 别忘了点击 Save changes（保存更改）。
7. 切换到 Secrets（密钥）选项卡。
8. 复制 Internal Integration Token（内部集成令牌），并将其作为 n8n 的 Internal Integration Secret（内部集成密钥）填入。

有关对服务进行身份验证的更多信息，请参考 内部集成认证流程设置文档。

将 Notion 页面共享给集成

为了让您的集成能够与 Notion 交互，您必须授予集成页面权限，使其可以访问 Notion 工作区中的一个或多个页面：

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

一旦您至少将一个页面共享给该集成，即可开始发送 API 请求。如果页面未被共享，所有 API 请求都将返回错误。 更多详情请参考 集成权限说明。

使用 OAuth2

要配置此凭据，您需要：

• Client ID（客户端 ID）：在创建公开集成时生成。
• Client Secret（客户端密钥）：在创建公开集成时生成。

您必须创建一个 Notion 集成，并将其设置为公开分发：

1. 进入您的 Notion 集成仪表板。
2. 点击 + New integration（新建集成） 按钮。
3. 为您的集成输入一个 Name（名称），例如 n8n integration。如有需要，可添加一个 Logo（图标）。
4. 点击 Submit（提交） 以创建集成。
5. 打开 Capabilities（功能权限） 标签页，并启用以下权限：
   • Read content（读取内容）
   • Update content（更新内容）
   • Insert content（插入内容）
   • User information without email addresses（用户信息，不含电子邮件地址）
6. 点击 Save changes（保存更改）。
7. 转到 Distribution（分发） 标签页。
8. 开启 Do you want to make this integration public?（是否希望此集成公开？） 的开关。
9. 在 Organization Information（组织信息） 部分填写您的公司名称和网站。
10. 复制 n8n 的 OAuth Redirect URL（OAuth 重定向 URL），并将其添加到 Notion 集成的 OAuth Domain & URLs（OAuth 域名和 URL） 部分的 Redirect URI（重定向 URI） 列表中。
11. 转到 Secrets（密钥） 标签页。
12. 复制 Client ID 和 Client Secret，并将它们填入 n8n 的凭据配置中。

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

内部集成 vs. 公开集成#

内部（Internal） 集成具有以下特点：

• 仅针对单个工作区。
• 仅该工作区的成员可以访问。
• 适用于自定义工作区功能增强。

内部集成使用更简单的认证方式（集成密钥，integration secret），在发布前无需经过安全审核。

公开（Public） 集成具有以下特点：

• 可在多个不相关的工作区中使用。
• 任何 Notion 用户均可访问，不受其所在工作区限制。
• 适用于满足广泛使用场景的需求。

公开集成使用 OAuth 2.0 协议进行认证，并且在发布前需要通过 Notion 的安全审核。

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