Notion

The Notion piece in ZBrain Flow provides seamless integration with Notion workspaces, allowing you to automate interactions with your Notion databases, pages, and content. This powerful connector enables you to programmatically create, update, and query Notion resources directly from your workflows. With Notion integration, you can build automations that maintain your knowledge base, update project management systems, document processes, and synchronize information between Notion and other platforms without manual intervention.

How to Use Notion in ZBrain Flow?

Step 1: Select Notion as Your Connection

• Click on the '+' button in the Flow and search for Notion.

• Select Notion.

• Decide on the action you need, then select it. ZBrain Flow provides several options:

  • Create Database Item – Adds new entries to your Notion databases.

  • Update Database Item – Modifies existing database entries.

  • Find Database Item – Searches for specific items in your databases.

  • Create Page – Generates new pages within your Notion workspace.

  • Append to Page – Add content to existing Notion pages.

  • Get Block Content – Retrieve content from Notion pages.

  • Custom API Call – Make specialized API requests to Notion.

How to Create a Database Item

Step 1: Connect to Notion

• Open the ‘Connection’ dropdown and click on ‘Create Connection.’ A popup window appears.

• Give a unique name for the connection in ‘Connection Name.’

• Click the ‘Connect’ button to authenticate and link your Notion account.

• Once connected, click ‘Save’ to complete the setup.

Step 2: Select Target Database

• Once connected, use the ‘Database’ dropdown to choose which Notion database you want to add an item to. The dropdown will show all databases you have access to in your Notion workspace.

Step 3: Define Item Content

• In the ‘Content’ field, enter the information for the new database item.

How to Update Existing Notion Database Items

Step 1 & Step 2

For connecting to Notion and selecting your target database, follow the first two steps in the "How to Create a Database Item?" section above.

Step 3: Select the Item to Update

• From the ‘Database Item’ dropdown, select the specific entry you want to modify. This dropdown will display all existing items in the database you selected.

Step 4: Define the Content to be Updated

• Enter the new information you want to change in the selected database item.

How to Find Notion Database Item

Steps 1 & 2

• For connecting to Notion and selecting your target database, follow the first two steps in the "How to Create a Database Item?" section above.

How to Create New Notion Pages

Step 1

• For connecting to Notion, follow the first step in the "How to Create a Database Item?" section above.

Step 2: Select Parent Page

• From the ‘Page’ dropdown, select the parent page where you want to create your new page. Note that only your 100 most recently edited pages will appear in this list.

Step 3: Set Page Title

• In the ‘Title’ field, enter the name for your new page. This will appear as the heading of your page in Notion.

Step 4: Add Page Content

• In the ‘Content’ field, enter the information you want to include on your page.

How to Add Content to Existing Notion Pages

Steps 1 & 2

• For connecting to Notion and selecting your target page, follow the same steps as in the "How to Create New Notion Pages" section above.

Step 3: Enter Content to Append

• In the ‘Content’ field, enter the information you want to add to the existing page. You can use markdown formatting for structured content.

How to Get Block Content

Step 1

• For connecting to Notion, follow the first step in the "How to Create a Database Item?" section above.

Step 2: Specify Block ID

• In the ‘Page or parent block ID’ field, enter the ID of the page or block you want to retrieve content from. This can be found in the URL of the Notion page or obtained from previous Notion operations.

Step 3: Configure Output Format

• Toggle Markdown on if you want the content converted to markdown format.

• Leave it off to receive the raw Notion block structure in JSON format.

Step 4: Set Retrieval Depth

• Use the ‘Depth’ field to specify how many levels of nested content to retrieve. The default is 1, which retrieves only top-level blocks.

How to Make Custom API Call

Step 1

• For connecting to Notion, follow the first step in the "How to Create a Database Item?" section above.

Step 2: Enter API Endpoint

• In the 'URL' field, enter the full Notion API endpoint you want to call.

Step 3: Select Request Method

• From the 'Method' dropdown, choose the appropriate HTTP method (GET, POST, PATCH, etc.).

Step 4: Configure Headers (Optional)

• Click 'Add Item' in the 'Headers' section to add any custom headers. Note that authorization headers are automatically included from your connection.

Step 5: Add Query Parameters (Optional)

• Click 'Add Item' in the 'Query Parameters' section to add URL parameters. These are useful for filtering, sorting, or limiting results.

Step 6: Specify Request Body (Optional)

• For POST, PUT, or PATCH requests, enter the JSON body content.

• This should follow the structure specified in the Notion API documentation.

Step 7: Configure Error Handling (Optional)

• Enable 'No Error on Failure' if you want the flow to treat error responses as valid.

• Set a 'Timeout' value (in seconds) to limit how long to wait for a response.