AAirbyteHelp Center

Guide

Add Connector - Notion

14 stepsAgent View (JSON)

Overview

Airbyte's Agent Engine allows AI agents to fetch, search, and write data across your connected tools. Adding a Notion connector creates a secure, reusable credential that your agents can use to interact with Notion pages without storing passwords or API keys directly in your codebase. This workflow guides you through Notion's OAuth authorization process, which protects your account security while allowing Airbyte to access only the pages you explicitly permit. Once saved, the credential is ready for use across multiple agent workflows.

Before you begin

  • An active Airbyte account with access to the Credentials section (app.airbyte.ai)
  • A Notion account with workspace owner or admin permissions
  • If using Notion AI Connectors (beyond basic page read access), a Notion Business or Enterprise Plan
  • At least one Notion page that you intend to grant Airbyte access to

Step by step

1
ClickCredentials

Navigate to the Credentials section in Airbyte by clicking the Credentials link in the top navigation. This is where you manage all connector authentications and API keys.

Step 1
2
ClickAdd Credential

Click the 'Add Credential' button to begin creating a new connector credential. This opens a list of available connectors to authenticate.

Step 2
3
ClickNotion

Select 'Notion' from the available connectors. This initiates the Notion-specific authentication flow.

Step 3
4
ClickAuthenticate your Notion account

Click the 'Authenticate your Notion account' button to begin the OAuth authorization process. This will redirect you to Notion's login and permission screen.

Tip. Ensure your browser allows pop-ups from app.airbyte.ai, as the Notion authentication window may open in a new tab or window.
Step 4
5
Switch Tab

The browser automatically switches to the new Notion authentication tab. If the tab doesn't open automatically, check for browser pop-up blockers or manually switch to the Notion tab that appears.

6
Navigate

You are now on Notion's website (www.notion.so) in the authentication flow. If you are not already logged in, Notion will prompt you to log in with your workspace credentials.

Tip. Log in with the same Notion account that owns or administers the workspace containing the pages you want to connect to Airbyte.
7
ClickSelect pages

Click the 'Select pages' button to view and choose which Notion pages Airbyte is allowed to access. This is a critical security step—only selected pages will be available to your agents.

Step 7
8
TypeSearch pages

Use the 'Search pages' text field to filter and locate specific pages in your Notion workspace. Type the page name or keyword to narrow the list if you have many pages.

Tip. Search is helpful if you have a large workspace and want to quickly find the exact pages your agents need to access.
9
ClickTeamspaces

Click on 'Teamspaces' (or the specific workspace/collection folder name) to expand and view pages within that section of your Notion workspace. This helps you navigate the page hierarchy.

Step 9
10
Clickcheckbox

Check the checkbox next to each page you want to grant Airbyte access to. You can select multiple pages—only the checked pages will be accessible to your agents.

Tip. Select only the pages your agents actually need. Limiting access follows the principle of least privilege and reduces security risk.
Step 10
11
ClickAllow access

Click the 'Allow access' button to confirm your page selections and grant Airbyte permission to access the chosen pages in your Notion workspace. This completes Notion's OAuth authorization.

Warning. Once you click 'Allow access,' Airbyte will be granted access to the selected pages. You can revoke this access later through your Notion integration settings if needed.
Step 11
12
Clicklink

Notion displays a confirmation or callback link that redirects you back to Airbyte. Click this link (or allow the automatic redirect) to return to Airbyte and complete the credential setup.

Tip. If the redirect does not happen automatically after a few seconds, look for a 'Return to Airbyte' or similar link on the Notion confirmation page.
Step 12
13
Navigate

The browser navigates back to app.airbyte.ai and displays the credential summary, showing your authenticated Notion account and the pages you selected.

14
ClickSave

Click the 'Save' button to persist the Notion connector credential in Airbyte. The credential is now available for use in agent connections and workflows.

Warning. If you do not click 'Save,' the credential will not be stored and you will need to redo the authentication process.
Step 14

Confirm it worked

  1. 1The credential appears in your Airbyte Credentials list with a 'Connected' or 'Active' status indicator
  2. 2The Notion connector displays the authenticated workspace name and the list of selected pages
  3. 3You can close the credential details and return to the Credentials dashboard without error messages
  4. 4The saved credential is available in the dropdown when creating a new Airbyte connection or configuring an agent

Common issues

Keep reading

Use AI connectors to access more of your team’s knowledge

Use AI connectors to access more of your team’s knowledge Play --- In an ideal world, your team's knowledge would be neatly organized in one place, regularly updated, and consistently shared across

notion.so

Notion AI Connectors – Notion Help Center

Notion AI Connectors – Notion Help Center --- Note: To connect third-party apps to Notion AI, you must be on the Business or Enterprise Plan. Notion Mail is free to connect for all plans; you’ll ne

notion.com

Add & manage connections – Notion Help Center

Add & manage connections – Notion Help Center --- Note: On Enterprise Plans, the following can be restricted to workspace owners: The ability to add connections and decide who can connect or discon

notion.so