Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Notion

Connect Notion with Flows360 to automate page, database and content workflows.

CategoryProductivity
AuthenticationOAuth 2.0, custom
Version0.7.1
Published scopes0 published scopes
Last updatedSeptember 21, 2026

Overview

Connect Notion with Flows360

Connect Notion with Flows360 to automate page, database and content workflows.

Use the Notion connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 37 actions and 4 triggers.

Available actions

  • List Databases
  • Create Database Item
  • Update Database Item
  • Find Database Item
  • List Pages
  • Create Page
  • Append to Page
  • Get block content
  • Plus 29 additional declared actions.

Available triggers

  • New Database Item
  • Updated Database Item
  • New Comment
  • Updated Page

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: Notion
  • Package: @activepieces/piece-notion@0.7.1
  • Exact artifact digest: sha256:83279566bce629a9930d6933f871de44f20f30f2dc02831c93c695e75adeb7f5
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

OAUTH2, CUSTOM AUTH. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • List Databases (list_databases), Lists Notion databases accessible by the connected account with pagination support. Classification: read.
  • Create Database Item (create_database_item), Add a new item to a Notion database with custom field values and optional content. Ideal for creating tasks, records, or entries in structured databases. Classification: read.
  • Update Database Item (update_database_item), Update specific fields in a Notion database item. Perfect for maintaining data, tracking changes, or syncing information across systems. Classification: read.
  • Find Database Item (notion-find-database-item), Searches for an item in database by field. Classification: read.
  • List Pages (list_database_pages), Lists pages in a Notion database with optional field filters and pagination. Classification: read.
  • Create Page (createPage), Create a new Notion page as a sub-page with custom title and content. Perfect for organizing documentation, notes, or creating structured page hierarchies. Classification: read.
  • Append to Page (append_to_page), Appends content to the end of a page. Classification: read.
  • Get block content (getPageOrBlockChildren), Retrieve the actual content of a page (represented by blocks). Classification: read.
  • Archive Database Item (archive_database_item), Archive (soft-delete) a database item without permanently removing it. Archived items can be restored later if needed. Classification: read.
  • Restore Database Item (restore_database_item), Restore an archived database item back to active status. Perfect for recovering accidentally archived tasks, projects, or records. Classification: read.
  • Add Comment (add_comment), Add a comment to any Notion page to start discussions, provide feedback, or leave notes for team collaboration. Classification: read.
  • Retrieve Database Structure (retrieve_database), Get detailed information about a Notion database including all its properties, field types, and configuration. Perfect for building dynamic forms, validation rules, or understanding database schemas. Classification: read.
  • Get Page Comments (get_page_comments), Retrieve all comments from a Notion page, organized by discussion threads. Perfect for tracking feedback, managing reviews, or monitoring page discussions. Classification: read.
  • Find Page (find_page), Search for Notion pages by title with flexible matching options. Perfect for finding specific pages, building page references, or creating automated workflows based on page discovery. Classification: read.
  • Create Page (notion_create_page), Creates a new sub-page under an existing Notion page, with a title and optional markdown body. Classification: read.
  • Get Page (notion_get_page), Fetches a single page's metadata and property values by id (a database row is a page). Classification: read.
  • Archive or Restore Page (notion_archive_page), Archives (trashes) or restores any page or database row by id via its archived flag. Classification: read.
  • Move Page (notion_move_page), Moves a page under a different parent page (or into a database as a row). Classification: read.
  • Append Content to Page (notion_append_to_page), Appends new block content (parsed from markdown) to the end of a page or block. Classification: read.
  • Get Page or Block Content (notion_get_block_children), Reads the body content of a page or block by recursively listing its child blocks, optionally rendered as markdown. Classification: read.
  • Update Block Text (notion_update_block), Replaces the text content of a single existing block by id. Classification: read.
  • Delete Block (notion_delete_block), Deletes (archives) a single block by id, removing it from its page. Classification: read.
  • Add Comment (notion_add_comment), Posts a new comment thread on a Notion page. Classification: read.
  • Get Page Comments (notion_get_page_comments), Lists all comments on a page, grouped into discussion threads. Classification: read.
  • Search Pages and Databases (notion_search), Searches the workspace by title for pages and/or databases shared with the integration, with exact or partial matching. Classification: read.
  • List Users (notion_list_users), Lists the people and bots in the workspace, returning each user's id, name, and type. Classification: read.
  • Get User (notion_get_user), Fetches a single workspace user's details by id. Classification: read.
  • Get Database Schema (notion_get_database), Retrieves a Notion database's schema: its property names, field types, and select/status/relation options. Classification: read.
  • Query Database (notion_query_database), Queries a Notion database with the API's native filter and sort JSON objects (compound AND/OR, ranges, dates, contains, etc.). Classification: read.
  • Create Database (notion_create_database), Creates a new inline Notion database under a parent page, with a title and a property-schema object defining its columns. Classification: read.
  • Update Database Schema (notion_update_database_schema), Updates a Notion database's title and/or column schema (add, rename, retype, or remove properties) by id. Classification: read.
  • Create Database Item (notion_create_database_item), Creates a new row (page) in a Notion database, setting its property values from a raw Notion properties object, with optional body content. Classification: read.
  • Update Database Item (notion_update_database_item), Overwrites property values on an existing Notion database row, identified by its page id, from a raw Notion properties object. Classification: read.
  • Find Database Item (notion_find_database_item), Finds rows in a Notion database matching a raw Notion filter object, returning the first match and all matches. Classification: read.
  • Archive Database Item (notion_archive_database_item), Archives (soft-deletes) a Notion database item by its page id, keeping it recoverable. Classification: read.
  • Restore Database Item (notion_restore_database_item), Restores an archived Notion database item back to active status by its page id. Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • New Database Item, polling.
  • Updated Database Item, polling.
  • New Comment, polling.
  • Updated Page, polling.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

AuthenticationOAuth 2.0, custom
Supported objects41
Supported actionsNot published
Triggers4

Authentication

Authentication method: OAuth 2.0, custom

Authentication profiles

connection · oauth2
connection_2 · custom
  • Internal Integration Token Required · protected credential

Supported objects

ObjectReadWriteNotes
List Databases Yes No Lists Notion databases accessible by the connected account with pagination support.
Create Database Item Yes No Add a new item to a Notion database with custom field values and optional content. Ideal for creating tasks, records, or entries in structured databases.
Update Database Item Yes No Update specific fields in a Notion database item. Perfect for maintaining data, tracking changes, or syncing information across systems.
Find Database Item Yes No Searches for an item in database by field.
List Pages Yes No Lists pages in a Notion database with optional field filters and pagination.
Create Page Yes No Create a new Notion page as a sub-page with custom title and content. Perfect for organizing documentation, notes, or creating structured page hierarchies.
Append to Page Yes No Appends content to the end of a page.
Get block content Yes No Retrieve the actual content of a page (represented by blocks).
Archive Database Item Yes No Archive (soft-delete) a database item without permanently removing it. Archived items can be restored later if needed.
Restore Database Item Yes No Restore an archived database item back to active status. Perfect for recovering accidentally archived tasks, projects, or records.
Add Comment Yes No Add a comment to any Notion page to start discussions, provide feedback, or leave notes for team collaboration.
Retrieve Database Structure Yes No Get detailed information about a Notion database including all its properties, field types, and configuration. Perfect for building dynamic forms, validation rules, or understanding database schemas.
Get Page Comments Yes No Retrieve all comments from a Notion page, organized by discussion threads. Perfect for tracking feedback, managing reviews, or monitoring page discussions.
Find Page Yes No Search for Notion pages by title with flexible matching options. Perfect for finding specific pages, building page references, or creating automated workflows based on page discovery.
Create Page Yes No Creates a new sub-page under an existing Notion page, with a title and optional markdown body.
Get Page Yes No Fetches a single page's metadata and property values by id (a database row is a page).
Archive or Restore Page Yes No Archives (trashes) or restores any page or database row by id via its archived flag.
Move Page Yes No Moves a page under a different parent page (or into a database as a row).
Append Content to Page Yes No Appends new block content (parsed from markdown) to the end of a page or block.
Get Page or Block Content Yes No Reads the body content of a page or block by recursively listing its child blocks, optionally rendered as markdown.
Update Block Text Yes No Replaces the text content of a single existing block by id.
Delete Block Yes No Deletes (archives) a single block by id, removing it from its page.
Add Comment Yes No Posts a new comment thread on a Notion page.
Get Page Comments Yes No Lists all comments on a page, grouped into discussion threads.
Search Pages and Databases Yes No Searches the workspace by title for pages and/or databases shared with the integration, with exact or partial matching.
List Users Yes No Lists the people and bots in the workspace, returning each user's id, name, and type.
Get User Yes No Fetches a single workspace user's details by id.
Get Database Schema Yes No Retrieves a Notion database's schema: its property names, field types, and select/status/relation options.
Query Database Yes No Queries a Notion database with the API's native filter and sort JSON objects (compound AND/OR, ranges, dates, contains, etc.).
Create Database Yes No Creates a new inline Notion database under a parent page, with a title and a property-schema object defining its columns.
Update Database Schema Yes No Updates a Notion database's title and/or column schema (add, rename, retype, or remove properties) by id.
Create Database Item Yes No Creates a new row (page) in a Notion database, setting its property values from a raw Notion properties object, with optional body content.
Update Database Item Yes No Overwrites property values on an existing Notion database row, identified by its page id, from a raw Notion properties object.
Find Database Item Yes No Finds rows in a Notion database matching a raw Notion filter object, returning the first match and all matches.
Archive Database Item Yes No Archives (soft-deletes) a Notion database item by its page id, keeping it recoverable.
Restore Database Item Yes No Restores an archived Notion database item back to active status by its page id.
Custom API Call Yes No Make a custom API call to a specific endpoint
New Database Item Yes No polling trigger declared by the pinned package.
Updated Database Item Yes No polling trigger declared by the pinned package.
New Comment Yes No polling trigger declared by the pinned package.
Updated Page Yes No polling trigger declared by the pinned package.

Triggers

New Database Item · Poll

Triggers when an item is added to a database.

Inputs

  • database_id · string
Updated Database Item · Poll

Triggers when an item is updated in a database.

Inputs

  • database_id · string
New Comment · Poll

Triggers whenever someone adds a new comment to a specific Notion page. Perfect for notifications, review workflows, or automated responses to team feedback.

Inputs

  • page_id · string
Updated Page · Poll

Triggers whenever any page in your Notion workspace is modified or updated. Ideal for syncing content changes, backup processes, or notifying teams about documentation updates.

Setup

Setup

  1. Add the Notion connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • Internal Integration Token (accessToken), required; stored as a sensitive connection value.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-notion@0.7.1; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 37 actions and 4 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required Notion connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-notion@0.7.1 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com