Notion
Connect BizFirst workflows to your Notion workspace — read and write databases, manage pages, append content blocks, query users, and trigger on new activity.
What this node does: The Notion node provides programmatic access to the Notion API across five resources: database, page, block, user, and trigger. Use it to create task pages from form submissions, query filtered database views, append structured content to meeting notes, sync workspace member lists, and trigger workflows when new pages are added to a database.
Resources & Operations (16 total)
database 5 Operations
| Operation | Description |
|---|---|
database/get | Retrieve a database's schema — property definitions, title, and icon. Use this to inspect a database structure before writing to it. |
database/getMany | List all databases accessible to the integration. Returns database titles, IDs, and last edited times. Supports pagination via PageSize and StartCursor. |
database/search | Search for databases by title keyword. Returns matching databases accessible to the integration. |
database/query | Query a database with optional Notion filter and sort objects. Returns matching pages (database rows) as structured objects. Supports pagination and ReturnAll mode. |
database/createPage | Create a new page (row) in a database. Requires a Properties JSON object matching the database schema. Optionally add content blocks and an icon. |
page 4 Operations
| Operation | Description |
|---|---|
page/createStandalone | Create a new standalone page as a child of an existing page. Specify the title, optional content blocks, and an icon. |
page/get | Retrieve a page's properties and metadata by its ID. Use Simplify to flatten the Notion API's verbose property format into plain key-value pairs. |
page/update | Update one or more properties of an existing page, or toggle the Archived flag to hide the page from the workspace. |
page/archive | Archive a page by ID (sets archived=true). Archived pages are hidden from the workspace but not permanently deleted. |
block 2 Operations
| Operation | Description |
|---|---|
block/getChildren | Retrieve the child blocks of a page or block. Returns an array of block objects with their type and content. Supports pagination and ReturnAll. |
block/appendChildren | Append one or more blocks to the end of a page or block. Pass a JSON array of Notion block objects. Use this to programmatically add meeting notes, report sections, or formatted content. |
user 2 Operations
| Operation | Description |
|---|---|
user/get | Retrieve a workspace user by their ID. Returns name, email address, avatar URL, and user type (person or bot). |
user/getMany | List all members of the Notion workspace. Supports pagination and ReturnAll mode. Use this to build team directories or validate assignee values. |
trigger 3 Operation Modes
| Mode | Description |
|---|---|
trigger/pageAdded | Polls a specified database at a configurable interval and starts the workflow when a new page (row) is detected. |
trigger/pageUpdated | Polls a database and starts the workflow when an existing page's properties or content are updated. |
trigger/webhook | Accepts an inbound webhook from Notion or an intermediary service. Starts the workflow immediately on receipt without polling delay. |
Key Use Cases
- Project management automation: When a form is submitted or a Jira issue is created, automatically add a new row to a Notion project database with status, owner, and due date properties populated.
- Knowledge base maintenance: Append structured meeting notes, decision logs, or AI-generated summaries to Notion pages directly from workflow outputs.
- CRM in Notion: Query a Notion database filtered by deal stage, process each result through a Loop node, and trigger follow-up email sequences via the Email SMTP node.
- Content pipeline: Trigger a workflow whenever a new content item is added to a Notion editorial database. Route it through review, draft generation, and publishing stages.
- Team digest: Weekly scheduled workflow gets all workspace users, queries their assigned tasks from a Notion database, and sends a personalised summary email to each team member.
Authentication Setup
Integration must be shared with databases: Notion integrations do not automatically have access to all workspace content. After creating your integration and obtaining the API token, open each Notion database or page you want to access and click Share → Invite, then select your integration by name. The node will return a 404 error for any resource not explicitly shared with the integration.
Two authentication methods are supported:
- ApiToken: For internal integrations. Create a new integration at notion.so/my-integrations, copy the Internal Integration Token, and paste it into the BizFirst credential. This is the simplest method for single-workspace automations.
- OAuth2: For public or multi-workspace integrations. Requires
ClientId,ClientSecret, andAccessTokenobtained through the Notion OAuth2 authorisation flow.
In This Guide
Configuration
Complete property reference for all 16 operations. Includes Notion property types, filter syntax, and example Properties JSON for database page creation.
Input & Output
Page object schema, database query results format, and all supported block types with their content structure.
Examples
Five real-world examples: create task page, query incomplete tasks, append meeting notes, team digest, and page-added trigger.