Docs

Notion

Add a bot to Notion using the official integration.

The Notion Integration with Botpress enables seamless integration to boost productivity, allowing interactions such as commenting on discussions or pages and database manipulations right from your Botpress bot.

Setup

    In Botpress Studio, select Explore Hub in the upper-right corner.

    Search for the Notion integration, then select Install Integration.

    In the Configuration menu, select Authorize Notion.

    Follow the instructions to connect Botpress to your Notion account.

    For advanced use cases, you can configure the integration manually using a Notion integration token.

    Step 1: Install the integration in Botpress

    In Botpress Studio, select Explore Hub in the upper-right corner.

    Search for the Notion integration, then select Install Integration.

    In the Configuration menu, select the drop-down and choose Configure the integration using a Notion integration token.

    You should see two fields:

    • Internal Integration Secret
    • Webhook Verification Secret

    Leave these empty for now—you’ll come back to them after setting up the integration in Notion.

    Step 2: Create an integration in Notion

    Next, create a corresponding integration in Notion:

    Go to your integrations page in Notion.

    Select New integration.

    Enter an Integration Name and Associated workspace for the integration. Then, select Save.

    Select Configure integration settings.

    Under Internal Integration Secret, select Show, then Copy.

    Go back to the integration’s configuration menu in Botpress. Then, paste the secret into the Internal Integration Secret.

    Select Save Configuration.

    Step 3: Give access to pages and databases

    For your bot to interact with your Notion workspace, you need to manually specify which pages and databases it has access to:

    In your Notion integration’s settings, go to the Access tab.

    Select Edit access.

    Select the pages you want your bot to have access to. Then, select Save.

    Step 4: Configure webhook events (optional)

    If you want to use the integration’s Triggers and have your bot respond to events in your Notion workspace, follow the steps below:

    In the integration’s configuration menu in Botpress, copy the webhook URL (starting with https://webhook.botpress.cloud/).

    In your Notion integration’s settings, go to the Webhooks tab. Then, select + Create a subscription.

    Paste the webhook URL you copied in the Webhook URL field.

    Under Select the events to listen to, select the following events:

    • Page created
    • Page deleted
    • Comment created

    Scroll down to the bottom of the page and select Verify.

    In Botpress, go to your bot’s most recent logs. Copy the verification token sent from Notion.

    Go back to your Notion integration and paste the token in the Verification token field.

    Select Verify subscription.

    Finally, go back to the integration’s Configuration menu in Botpress. Paste the verification token into the Webhook Verification Secret field.

    Cards

    Add Comment

    Add a comment to a page, block, or discussion in Notion

    inputobject
    outputobject

    Append Blocks to Page

    Append a markdown text to a page in Notion. The markdown text will be converted to notion blocks.

    inputobject
    outputobject

    Create Page

    Create a new page in Notion

    inputobject
    outputobject

    Delete Block

    Delete a block in Notion

    inputobject
    outputobject

    List items in folder

    List the files and folders in a folder

    inputobject
    outputobject

    Transfer file to Botpress

    Transfer a file from an external service to Botpress

    inputobject
    outputobject

    Get Data Source

    Get a data source from Notion

    inputobject
    outputobject

    Get Database

    Get a database from Notion

    inputobject
    outputobject

    Get Page

    Get a page from Notion

    inputobject
    outputobject

    Get Page Content

    Get the content blocks of a page or block in Notion

    inputobject
    outputobject

    Search by Title

    Search for pages and databases in Notion. Optionally filter by title. Only returns items that have been shared with the integration.

    inputobject
    outputobject

    Update Page Properties

    Update one or more properties on a Notion page using raw Notion properties JSON

    inputobject
    outputobject

    Triggers

    aggregateFileChanges

    payloadobject

    Comment Created

    A comment was created in Notion

    payloadobject

    fileCreated

    payloadobject

    fileDeleted

    payloadobject

    fileUpdated

    payloadobject

    folderDeletedRecursive

    payloadobject