Notion v2
Provides integration with Notion to read and maintain pages, databases, data sources, views, blocks, comments, and other supported resources. Use it to synchronize workspace content and automate updates from other systems.
Notion is a workspace for pages, structured data, documents, and team collaboration.
Revision History
0.0.0.2 - Initial release.
Connection
Use a Notion OAuth Connection.
| Property | Type | Description |
|---|---|---|
Client ID |
String | OAuth client identifier issued for the app. |
Client Secret |
Masked | OAuth client secret issued for the app. |
Access Token |
Masked | Access token populated through account authorization. |
Refresh Token |
Masked | Refresh token used to renew access and updated when the provider rotates it. |
Setup Notes
- Run this Node on a Cloud Runtime.
- Configure the Notion OAuth app and its Flowgear callback URL, enter the client credentials, and complete account authorization.
- Grant access to the pages and resources the Workflow needs, then test the Connection.
- Enable the required integration capabilities. Comment operations need read-comment or insert-comment access; user operations need user-information access.
Methods
Select a template for the supported resource and operation. The Node sends the Notion API version 2026-03-11.
Query
Searches the workspace or reads pages, page properties, page Markdown, databases, data sources, views and cached view results, blocks and children, comments, users, custom emojis, or asynchronous tasks.
| Parameter | Type | Description |
|---|---|---|
Connection |
Connection | Connection used to authenticate the selected operation. |
OperationId |
String | Operation identifier populated by the selected template. Select a template instead of entering this manually. |
Options |
Object | Route identifiers, filters, sorts, and other query values from the selected template. |
| Return | Type | Description |
|---|---|---|
Response |
Array | Provider-shaped business rows without a Flowgear object. Collection queries with no matches return zero rows. |
Create
Creates pages, databases, data sources, views, cached view queries, or comments, or appends block children.
| Parameter | Type | Description |
|---|---|---|
Connection |
Connection | Connection used to authenticate the selected operation. |
OperationId |
String | Operation identifier populated by the selected template. Select a template instead of entering this manually. |
Items |
Array | Request objects containing the route identifiers and provider fields shown by the selected template. |
| Return | Type | Description |
|---|---|---|
Response |
Array | Provider response fields with Flowgear.IsSuccess, Flowgear.Message, and Flowgear.Request for each processed request. |
Update
Updates pages, Markdown, databases, data-source schemas, views, blocks, or comments. Templates also support moving pages and changing in_trash where supported.
| Parameter | Type | Description |
|---|---|---|
Connection |
Connection | Connection used to authenticate the selected operation. |
OperationId |
String | Operation identifier populated by the selected template. Select a template instead of entering this manually. |
Items |
Array | Request objects containing the route identifiers and provider fields shown by the selected template. |
| Return | Type | Description |
|---|---|---|
Response |
Array | Provider response fields with Flowgear.IsSuccess, Flowgear.Message, and Flowgear.Request for each processed request. |
Delete
Moves blocks to trash or deletes comments, views, and cached view queries. Use the appropriate Update template to trash a page.
| Parameter | Type | Description |
|---|---|---|
Connection |
Connection | Connection used to authenticate the selected operation. |
OperationId |
String | Operation identifier populated by the selected template. Select a template instead of entering this manually. |
Items |
Array | Request objects containing the route identifiers and provider fields shown by the selected template. |
| Return | Type | Description |
|---|---|---|
Response |
Array | Provider response fields with Flowgear.IsSuccess, Flowgear.Message, and Flowgear.Request for each processed request. |
Usage Notes
- Collection queries follow provider continuation cursors automatically.
- Query rows preserve provider fields. Provider read failures surface to the Workflow; the first read completes before downstream enumeration starts.
- Mutation Methods process the first item before returning the output stream. Handled provider failures include failed
Flowgearmetadata and the input request. - Access tokens can be refreshed after an unauthorized response when a refresh token and client credentials are available.
Known Issues
- Search results are eventually consistent. Do not use search alone to verify a resource immediately after creation.
- Data-source queries are limited to 10,000 matching results. Cached view queries expire after 15 minutes and contain at most 10,000 matching rows.
- List Users does not include guests; retrieve a known guest ID directly when permitted.
- The Node exposes a curated operation list; use the available templates to identify supported operations.