Setup

To use Notion components in BroxiAI, you first need to create a Notion integration and configure it with the necessary capabilities. This guide will walk you through the process of setting up a Notion integration and granting it access to your Notion databases.

Prerequisites​

• A Notion account with access to the workspace where you want to use the integration.

• Admin permissions in the Notion workspace to create and manage integrations.

Create a Notion Integration​

1. Go to the Notion Integrations page.

2. Click on the "New integration" button.

3. Give your integration a name and select the workspace where you want to use it.

4. Click "Submit" to create the integration.

When creating the integration, make sure to enable the necessary capabilities based on your requirements. Refer to the Notion Integration Capabilities documentation for more information on each capability.

Configure Integration Capabilities​

After creating the integration, you need to configure its capabilities to define what actions it can perform and what data it can access.

1. In the integration settings page, go to the Capabilities tab.

2. Enable the required capabilities for your integration. For example:

   • If your integration needs to read data from Notion, enable the "Read content" capability.

   • If your integration needs to create new content in Notion, enable the "Insert content" capability.

   • If your integration needs to update existing content in Notion, enable the "Update content" capability.

3. Configure the user information access level based on your integration's requirements.

4. Save the changes.

Obtain Integration Token​

To authenticate your integration with Notion, you need to obtain an integration token.

1. In the integration settings page, go to the "Secrets" tab.

2. Copy the "Internal Integration Token" value. This token will be used to authenticate your integration with Notion.

Your integration token is a sensitive piece of information. Make sure to keep it secure and never share it publicly. Store it safely in your BroxiAI configuration or environment variables.

Grant Integration Access to Notion Databases​

For your integration to interact with Notion databases, you need to grant it access to the specific databases it will be working with.

1. Open the Notion database that you want your integration to access.

2. Click on the "Share" button in the top-right corner of the page.

3. In the "Invite" section, select your integration from the list.

4. Click "Invite" to grant the integration access to the database.

If your database contains references to other databases, you need to grant the integration access to those referenced databases as well. Repeat step 4 for each referenced database to ensure your integration has the necessary access.

Build with Notion Components in BroxiAI​

Once you have set up your Notion integration and granted it access to the required databases, you can start using the Notion components in BroxiAI.

BroxiAI provides the following Notion components:

• Search: Searches all pages and databases that have been shared with the integration. You can filter results to either pages or databases and specify the sort direction.

• List Users: Retrieves a list of users from the Notion workspace.

• List Database Properties: Retrieves the properties of a specified Notion database.

• Create Page: Creates a new page in a specified Notion database with the provided properties.

• Update Page Property: Updates the properties of an existing Notion page.

• Add Content to Page: Converts markdown text to Notion blocks and appends them to a specified Notion page.

• List Pages: Queries a Notion database with filtering and sorting options.

• Page Content Viewer: Retrieves the content of a Notion page as plain text.

Each of these components output both "Data" and "Tool":

• The "Data" output can be used directly in your BroxiAI for further processing or display.

• The "Tool" output can be utilized in BroxiAI Agents, allowing them to interact with Notion programmatically.

Additional Resources​

• Notion API Documentation
• Notion Integration Capabilities