CComposioHelp Center

Guide

Add Auth Config - Notion

9 stepsAgent View (JSON)

Overview

Composio manages authentication configurations that allow your AI agents to interact with external services like Notion. By creating an auth config, you establish a reusable, secure connection that can be applied across multiple sessions and agents without repeating authentication steps. Notion's public OAuth integration makes this setup straightforward. Auth configs are created once in your Composio dashboard and then referenced whenever you need authenticated Notion access—whether you're building a chat app, an agent workflow, or a custom integration. This is particularly valuable in production environments where you want centralized, auditable authentication management separate from individual user sessions.

Before you begin

  • Active Composio account with access to dashboard.composio.dev
  • Notion workspace admin or user account (you will be prompted to authorize during setup)
  • Understanding of what scopes (permissions) your Notion integration requires—common examples include read access to databases, pages, or write permissions for creating content

Step by step

1
ClickCreate

Start the authentication configuration workflow by clicking the Create button on the Composio dashboard. This opens the toolkit selection interface where you'll choose which service to authenticate.

Step 1
2
TypeSearch toolkits...

Search for the Notion toolkit by typing in the 'Search toolkits...' field. This filters the available toolkits so you can quickly locate Notion without scrolling through the entire list.

Tip. Type 'Notion' to narrow results. The full toolkit name is 'Notion OAuth 2.0 API Key'—you don't need to type the entire name.
3
ClickNNotionOAuth 2.0 API Key

Select the Notion OAuth 2.0 API Key toolkit from the filtered results by clicking on it. This confirms you want to create an authentication configuration for Notion.

Step 3
4
ClickNext

Click the Next button to proceed to the scope configuration step. This advances the workflow to where you'll define what permissions the Notion connection will have.

Step 4
5
TypeSearch scopes or type to add...

Begin selecting scopes by clicking in the 'Search scopes or type to add...' field. Type the scope names you need (for example, 'read:database' or 'read:pages') to add the appropriate permissions for your use case.

Tip. Scopes define what your authenticated Notion connection can do. Refer to the Notion OAuth documentation for a complete list of available scopes. Start with minimal scopes (read-only) and add write scopes only if your agent needs to create or modify content.
6
ClickScopesPermissions that connected accounts will have.

Open the Scopes permissions combobox by clicking on it. This displays available scopes you can select and add to your auth configuration.

Tip. The combobox may show recently used or recommended scopes. You can also continue typing in the search field to filter scopes by name.
Step 6
7
ClickScopesPermissions that connected accounts will have.

Click the Scopes combobox a second time to see the full list of available permissions, or to confirm your scope selections. This step ensures all required scopes are properly added to your configuration.

Tip. If you've already added scopes, clicking again will show which ones are selected (often marked with a checkmark). Review the list to ensure no required permissions are missing.
Step 7
8
ClickCreate Auth Config

Click the Create Auth Config button to finalize and save your Notion authentication configuration. This triggers the OAuth authorization flow and stores the config in your Composio dashboard.

Tip. After clicking, you may be redirected to Notion's login page to authorize Composio's access to your workspace. Complete the authorization prompts—this is required for the config to become active.
Warning. Ensure you are authorizing from the correct Notion account. Once created, this auth config will have the permissions you specified for the scopes selected above.
Step 8
9
TypeSearch toolkits...

The workflow may return to the toolkit search interface. You can now search for additional toolkits if you need to create more auth configs, or navigate away from this screen if you are finished.

Tip. If you only needed to set up Notion authentication, you can close this interface or return to your main dashboard. The Notion auth config is now saved and ready to use in sessions and agents.

Confirm it worked

  1. 1The auth configuration is successfully created and appears in your Composio dashboard's authentication configurations list
  2. 2The Notion OAuth 2.0 config is displayed with status showing it is active and ready to use
  3. 3You can select and reference this auth config when creating new sessions or agents that need Notion access

Common issues

Keep reading

Authorization - Notion Docs

> ## Documentation Index > > Fetch the complete documentation index at: https://developers.notion.com/llms.txt > Use this file to discover all available pages before exploring further. # Authorizati

developers.notion.com

Configuring authentication values for Notion - Writer Help Center

Configuring authentication values for Notion - Writer Help Center # Configuring authentication values for Notion Learn how to set up a Notion integration with the WRITER web app to enable a data sy

support.writer.com

How to build a Notion API integration

How to build a Notion API integration Reserve your seat for our next Fireside with the SVP of Product at Constellation1. Learn more → Login Get a Demo Get account Get a Demo API Docs Integrations

content.rollout.com