Use Notion to read and manage pages, databases, blocks, and comments. Query a database or search the workspace to find the content a workflow needs; webhook triggers can start workflows when content changes.
Connection guides: Internal integrations.
OAuth scopes
Sim requests no OAuth scopes for Notion. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.
| Setting | Value |
|---|---|
| Redirect URI | <NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/notion |
| Environment variables | NOTION_CLIENT_ID, NOTION_CLIENT_SECRET |
Use the block
Choose an operation and select a connected account. Use Search Workspace to find content, Query Database to retrieve rows from a database, or Append Content to add blocks to a page.
Actions
Notion Reader
Read content from a Notion page
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
pageId | string | Yes | The UUID of the Notion page to read |
Output
| Parameter | Type | Description |
|---|---|---|
url | string | Notion page URL |
created_time | string | ISO 8601 creation timestamp |
last_edited_time | string | ISO 8601 last edit timestamp |
content | string | Page content in markdown format |
title | string | Page title |
Read Notion Database
Read database information and structure from Notion
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
databaseId | string | Yes | The UUID of the Notion database to read |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Database UUID |
url | string | Notion database URL |
created_time | string | ISO 8601 creation timestamp |
last_edited_time | string | ISO 8601 last edit timestamp |
properties | object | Database properties schema |
title | string | Database title |
Notion Content Appender
Append content to a Notion page
Inputs and outputs
Notion Page Creator
Create a new page in Notion
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
parentId | string | Yes | The UUID of the parent Notion page where this page will be created |
title | string | No | Title of the new page |
content | string | No | Optional content to add to the page upon creation |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Page UUID |
url | string | Notion page URL |
created_time | string | ISO 8601 creation timestamp |
last_edited_time | string | ISO 8601 last edit timestamp |
title | string | Page title |
Notion Page Updater
Update properties of a Notion page
Inputs and outputs
Query Notion Database
Query and filter Notion database entries with advanced filtering
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
databaseId | string | Yes | The UUID of the Notion database to query |
filter | string | No | Filter conditions as JSON (optional) |
sorts | string | No | Sort criteria as JSON array (optional) |
pageSize | number | No | Number of results to return (default: 100, max: 100) |
startCursor | string | No | Pagination cursor returned by a previous request |
Output
| Parameter | Type | Description |
|---|---|---|
results | array | Array of page objects from the database |
↳ object | string | Always "page" |
↳ id | string | Page UUID |
↳ created_time | string | ISO 8601 creation timestamp |
↳ last_edited_time | string | ISO 8601 last edit timestamp |
↳ created_by | object | Partial user object |
↳ object | string | Always "user" |
↳ id | string | User UUID |
↳ last_edited_by | object | Partial user object |
↳ object | string | Always "user" |
↳ id | string | User UUID |
↳ archived | boolean | Whether the page is archived |
↳ in_trash | boolean | Whether the page is in trash |
↳ url | string | Notion page URL |
↳ public_url | string | Public web URL if shared, null otherwise |
↳ parent | object | Parent object specifying hierarchical relationship |
↳ type | string | Parent type: "database_id", "data_source_id", "page_id", "workspace", or "block_id" |
↳ database_id | string | Parent database UUID (if type is database_id) |
↳ data_source_id | string | Parent data source UUID (if type is data_source_id) |
↳ page_id | string | Parent page UUID (if type is page_id) |
↳ workspace | boolean | True if parent is workspace (if type is workspace) |
↳ block_id | string | Parent block UUID (if type is block_id) |
↳ icon | object | Page/database icon (emoji, custom_emoji, or file) |
↳ type | string | Icon type: "emoji", "custom_emoji", or "file" |
↳ emoji | string | Emoji character (if type is emoji) |
↳ custom_emoji | object | Custom emoji object (if type is custom_emoji) |
↳ id | string | Custom emoji UUID |
↳ name | string | Custom emoji name |
↳ url | string | URL to custom emoji image |
↳ file | object | Notion-hosted file (if type is file) |
↳ url | string | Authenticated URL valid for one hour |
↳ expiry_time | string | ISO 8601 timestamp when URL expires |
↳ external | object | External file (if type is external) |
↳ url | string | External file URL, returned as supplied; availability depends on the external host |
↳ cover | object | Page/database cover image |
↳ type | string | File type: "file", "file_upload", or "external" |
↳ file | object | Notion-hosted file object (when type is "file") |
↳ url | string | Authenticated URL valid for one hour |
↳ expiry_time | string | ISO 8601 timestamp when URL expires |
↳ file_upload | object | API-uploaded file object (when type is "file_upload") |
↳ id | string | File upload UUID |
↳ external | object | External file object (when type is "external") |
↳ url | string | External file URL, returned as supplied; availability depends on the external host |
↳ properties | object | Page property values (structure depends on parent type - database properties or title only) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for next page of results |
total_results | number | Number of results returned |
Search Notion Workspace
Search across all pages and databases in Notion workspace
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search terms to find pages and databases (leave empty to get all pages) |
filterType | string | No | Filter by object type: "page", "database", or leave empty for all |
pageSize | number | No | Number of results to return (default: 100, max: 100) |
startCursor | string | No | Pagination cursor returned by a previous request |
Output
| Parameter | Type | Description |
|---|---|---|
results | array | Array of search results (pages and/or databases) |
↳ object | string | Object type: "page" or "database" |
↳ id | string | Object UUID |
↳ created_time | string | ISO 8601 creation timestamp |
↳ last_edited_time | string | ISO 8601 last edit timestamp |
↳ created_by | object | Partial user object |
↳ object | string | Always "user" |
↳ id | string | User UUID |
↳ last_edited_by | object | Partial user object |
↳ object | string | Always "user" |
↳ id | string | User UUID |
↳ archived | boolean | Whether the object is archived |
↳ in_trash | boolean | Whether the object is in trash |
↳ url | string | Object URL |
↳ public_url | string | Public web URL if shared |
↳ parent | object | Parent object specifying hierarchical relationship |
↳ type | string | Parent type: "database_id", "data_source_id", "page_id", "workspace", or "block_id" |
↳ database_id | string | Parent database UUID (if type is database_id) |
↳ data_source_id | string | Parent data source UUID (if type is data_source_id) |
↳ page_id | string | Parent page UUID (if type is page_id) |
↳ workspace | boolean | True if parent is workspace (if type is workspace) |
↳ block_id | string | Parent block UUID (if type is block_id) |
↳ properties | object | Object properties |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for next page of results |
total_results | number | Number of results returned |
Create Notion Database
Create a new database in Notion with custom properties
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
parentId | string | Yes | ID of the parent page where the database will be created |
title | string | Yes | Title for the new database |
properties | json | No | Database properties as JSON object (optional, will create a default "Name" property if empty) |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Database UUID |
url | string | Notion database URL |
created_time | string | ISO 8601 creation timestamp |
properties | object | Database properties schema |
title | string | Database title |
Add Notion Database Row
Add a new row to a Notion database with specified properties
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
databaseId | string | Yes | ID of the database to add the row to |
properties | json | Yes | Row properties as JSON object matching the database schema (e.g., {"Name": {"title": [{"text": {"content": "Task 1"}}]}, "Status": {"select": {"name": "Done"}}}) |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Page UUID |
url | string | Notion page URL |
created_time | string | ISO 8601 creation timestamp |
last_edited_time | string | ISO 8601 last edit timestamp |
title | string | Row title |
Notion Append Block Children
Append new block children (content) to a Notion page or block
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
blockId | string | Yes | The UUID of the page or block to append children to |
children | json | Yes | Array of Notion block objects to append (max 100) |
after | string | No | UUID of an existing block to append the new children after |
Output
| Parameter | Type | Description |
|---|---|---|
content | string | Page content in markdown format, or comment text for create comment |
title | string | Page or database title |
url | string | Notion URL |
id | string | Page, database, block, comment, or user ID |
created_time | string | Creation timestamp |
last_edited_time | string | Last edit timestamp |
results | array | Array of results (pages, blocks, comments, or users) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for pagination |
total_results | number | Number of results returned |
properties | json | Database properties schema |
appended | boolean | Whether content was successfully appended |
type | string | Block type |
block | json | The full Notion block object |
has_children | boolean | Whether the block has nested blocks |
archived | boolean | Whether the block is archived |
discussion_id | string | Discussion thread ID |
name | string | User display name |
avatar_url | string | User avatar image URL |
email | string | User email address (person users only) |
Notion Retrieve Block
Retrieve a single Notion block by its UUID, including its type-specific content
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
blockId | string | Yes | The UUID of the block to retrieve |
Output
| Parameter | Type | Description |
|---|---|---|
content | string | Page content in markdown format, or comment text for create comment |
title | string | Page or database title |
url | string | Notion URL |
id | string | Page, database, block, comment, or user ID |
created_time | string | Creation timestamp |
last_edited_time | string | Last edit timestamp |
results | array | Array of results (pages, blocks, comments, or users) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for pagination |
total_results | number | Number of results returned |
properties | json | Database properties schema |
appended | boolean | Whether content was successfully appended |
type | string | Block type |
block | json | The full Notion block object |
has_children | boolean | Whether the block has nested blocks |
archived | boolean | Whether the block is archived |
discussion_id | string | Discussion thread ID |
name | string | User display name |
avatar_url | string | User avatar image URL |
email | string | User email address (person users only) |
Notion Retrieve Block Children
Retrieve the block children (content) of a Notion page or block
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
blockId | string | Yes | The UUID of the page or block whose children to retrieve |
startCursor | string | No | Pagination cursor returned by a previous request |
pageSize | number | No | Number of results to return (1-100, default 100) |
Output
| Parameter | Type | Description |
|---|---|---|
content | string | Page content in markdown format, or comment text for create comment |
title | string | Page or database title |
url | string | Notion URL |
id | string | Page, database, block, comment, or user ID |
created_time | string | Creation timestamp |
last_edited_time | string | Last edit timestamp |
results | array | Array of results (pages, blocks, comments, or users) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for pagination |
total_results | number | Number of results returned |
properties | json | Database properties schema |
appended | boolean | Whether content was successfully appended |
type | string | Block type |
block | json | The full Notion block object |
has_children | boolean | Whether the block has nested blocks |
archived | boolean | Whether the block is archived |
discussion_id | string | Discussion thread ID |
name | string | User display name |
avatar_url | string | User avatar image URL |
email | string | User email address (person users only) |
Notion Update Block
Update the content or archived state of a single Notion block
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
blockId | string | Yes | The UUID of the block to update |
block | json | Yes | Block-type object with the fields to update, e.g. {"paragraph": {"rich_text": [...]}} |
archived | boolean | No | Set to true to archive (delete) the block, or false to restore it |
Output
| Parameter | Type | Description |
|---|---|---|
content | string | Page content in markdown format, or comment text for create comment |
title | string | Page or database title |
url | string | Notion URL |
id | string | Page, database, block, comment, or user ID |
created_time | string | Creation timestamp |
last_edited_time | string | Last edit timestamp |
results | array | Array of results (pages, blocks, comments, or users) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for pagination |
total_results | number | Number of results returned |
properties | json | Database properties schema |
appended | boolean | Whether content was successfully appended |
type | string | Block type |
block | json | The full Notion block object |
has_children | boolean | Whether the block has nested blocks |
archived | boolean | Whether the block is archived |
discussion_id | string | Discussion thread ID |
name | string | User display name |
avatar_url | string | User avatar image URL |
email | string | User email address (person users only) |
Notion Delete Block
Delete (move to trash) a single Notion block
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
blockId | string | Yes | The UUID of the block to delete |
Output
| Parameter | Type | Description |
|---|---|---|
content | string | Page content in markdown format, or comment text for create comment |
title | string | Page or database title |
url | string | Notion URL |
id | string | Page, database, block, comment, or user ID |
created_time | string | Creation timestamp |
last_edited_time | string | Last edit timestamp |
results | array | Array of results (pages, blocks, comments, or users) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for pagination |
total_results | number | Number of results returned |
properties | json | Database properties schema |
appended | boolean | Whether content was successfully appended |
type | string | Block type |
block | json | The full Notion block object |
has_children | boolean | Whether the block has nested blocks |
archived | boolean | Whether the block is archived |
discussion_id | string | Discussion thread ID |
name | string | User display name |
avatar_url | string | User avatar image URL |
email | string | User email address (person users only) |
Notion Create Comment
Create a comment on a Notion page or within an existing discussion thread
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
pageId | string | No | UUID of the page to comment on (provide either pageId or discussionId) |
discussionId | string | No | UUID of an existing discussion thread to reply to |
content | string | Yes | The text content of the comment |
Output
| Parameter | Type | Description |
|---|---|---|
content | string | Page content in markdown format, or comment text for create comment |
title | string | Page or database title |
url | string | Notion URL |
id | string | Page, database, block, comment, or user ID |
created_time | string | Creation timestamp |
last_edited_time | string | Last edit timestamp |
results | array | Array of results (pages, blocks, comments, or users) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for pagination |
total_results | number | Number of results returned |
properties | json | Database properties schema |
appended | boolean | Whether content was successfully appended |
type | string | Block type |
block | json | The full Notion block object |
has_children | boolean | Whether the block has nested blocks |
archived | boolean | Whether the block is archived |
discussion_id | string | Discussion thread ID |
name | string | User display name |
avatar_url | string | User avatar image URL |
email | string | User email address (person users only) |
Notion List Comments
List unresolved comments on a Notion page or block
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
blockId | string | Yes | The UUID of the page or block whose comments to list |
startCursor | string | No | Pagination cursor returned by a previous request |
pageSize | number | No | Number of results to return (1-100, default 100) |
Output
| Parameter | Type | Description |
|---|---|---|
content | string | Page content in markdown format, or comment text for create comment |
title | string | Page or database title |
url | string | Notion URL |
id | string | Page, database, block, comment, or user ID |
created_time | string | Creation timestamp |
last_edited_time | string | Last edit timestamp |
results | array | Array of results (pages, blocks, comments, or users) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for pagination |
total_results | number | Number of results returned |
properties | json | Database properties schema |
appended | boolean | Whether content was successfully appended |
type | string | Block type |
block | json | The full Notion block object |
has_children | boolean | Whether the block has nested blocks |
archived | boolean | Whether the block is archived |
discussion_id | string | Discussion thread ID |
name | string | User display name |
avatar_url | string | User avatar image URL |
email | string | User email address (person users only) |
Notion List Users
List all users (members and bots) in the Notion workspace
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
startCursor | string | No | Pagination cursor returned by a previous request |
pageSize | number | No | Number of results to return (1-100, default 100) |
Output
| Parameter | Type | Description |
|---|---|---|
content | string | Page content in markdown format, or comment text for create comment |
title | string | Page or database title |
url | string | Notion URL |
id | string | Page, database, block, comment, or user ID |
created_time | string | Creation timestamp |
last_edited_time | string | Last edit timestamp |
results | array | Array of results (pages, blocks, comments, or users) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for pagination |
total_results | number | Number of results returned |
properties | json | Database properties schema |
appended | boolean | Whether content was successfully appended |
type | string | Block type |
block | json | The full Notion block object |
has_children | boolean | Whether the block has nested blocks |
archived | boolean | Whether the block is archived |
discussion_id | string | Discussion thread ID |
name | string | User display name |
avatar_url | string | User avatar image URL |
email | string | User email address (person users only) |
Notion Retrieve User
Retrieve a single Notion user by their UUID
Inputs and outputs
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | The UUID of the user to retrieve |
Output
| Parameter | Type | Description |
|---|---|---|
content | string | Page content in markdown format, or comment text for create comment |
title | string | Page or database title |
url | string | Notion URL |
id | string | Page, database, block, comment, or user ID |
created_time | string | Creation timestamp |
last_edited_time | string | Last edit timestamp |
results | array | Array of results (pages, blocks, comments, or users) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for pagination |
total_results | number | Number of results returned |
properties | json | Database properties schema |
appended | boolean | Whether content was successfully appended |
type | string | Block type |
block | json | The full Notion block object |
has_children | boolean | Whether the block has nested blocks |
archived | boolean | Whether the block is archived |
discussion_id | string | Discussion thread ID |
name | string | User display name |
avatar_url | string | User avatar image URL |
email | string | User email address (person users only) |
Triggers
A trigger starts a workflow when a supported event occurs in this service.
Notion Comment Created
Trigger workflow when a comment or suggested edit is added in Notion
Configuration and outputs
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | |
↳ id | string | Comment ID |
↳ entity_type | string | Entity type (comment) |
data | object | |
↳ page_id | string | Page ID that owns the comment thread |
↳ parent | object | |
↳ id | string | Parent page or block ID |
↳ parent_type | string | Parent type (page or block) |
Notion Database Created
Trigger workflow when a new database is created in Notion
Configuration and outputs
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | |
↳ id | string | Entity ID (page, database, block, comment, or data source ID) |
↳ entity_type | string | Entity type: page, database, block, comment, or data_source |
data | object | |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Database properties updated as part of the event, when provided by Notion |
↳ parent | object | |
↳ id | string | Parent page, database, workspace, or space ID |
↳ parent_type | string | Parent type: page, database, workspace, or space |
Notion Database Deleted
Trigger workflow when a database is deleted in Notion
Configuration and outputs
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | |
↳ id | string | Entity ID (page, database, block, comment, or data source ID) |
↳ entity_type | string | Entity type: page, database, block, comment, or data_source |
data | object | |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Database properties updated as part of the event, when provided by Notion |
↳ parent | object | |
↳ id | string | Parent page, database, workspace, or space ID |
↳ parent_type | string | Parent type: page, database, workspace, or space |
Notion Database Schema Updated
Trigger workflow when a database schema is modified in Notion
Configuration and outputs
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | |
↳ id | string | Entity ID (page, database, block, comment, or data source ID) |
↳ entity_type | string | Entity type: page, database, block, comment, or data_source |
data | object | |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Database properties updated as part of the event, when provided by Notion |
↳ parent | object | |
↳ id | string | Parent page, database, workspace, or space ID |
↳ parent_type | string | Parent type: page, database, workspace, or space |
Notion Page Content Updated
Trigger workflow when page content is changed in Notion
Configuration and outputs
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | |
↳ id | string | Entity ID (page, database, block, comment, or data source ID) |
↳ entity_type | string | Entity type: page, database, block, comment, or data_source |
data | object | |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Property IDs updated as part of the event, when provided by Notion |
↳ parent | object | |
↳ id | string | Parent page, database, workspace (space), or block ID |
↳ parent_type | string | Parent type: page, database, block, workspace, or space |
Notion Page Created
Trigger workflow when a new page is created in Notion
Configuration and outputs
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | |
↳ id | string | Entity ID (page, database, block, comment, or data source ID) |
↳ entity_type | string | Entity type: page, database, block, comment, or data_source |
data | object | |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Property IDs updated as part of the event, when provided by Notion |
↳ parent | object | |
↳ id | string | Parent page, database, workspace (space), or block ID |
↳ parent_type | string | Parent type: page, database, block, workspace, or space |
Notion Page Deleted
Trigger workflow when a page is deleted in Notion
Configuration and outputs
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | |
↳ id | string | Entity ID (page, database, block, comment, or data source ID) |
↳ entity_type | string | Entity type: page, database, block, comment, or data_source |
data | object | |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Property IDs updated as part of the event, when provided by Notion |
↳ parent | object | |
↳ id | string | Parent page, database, workspace (space), or block ID |
↳ parent_type | string | Parent type: page, database, block, workspace, or space |
Notion Page Properties Updated
Trigger workflow when page properties are modified in Notion
Configuration and outputs
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | |
↳ id | string | Entity ID (page, database, block, comment, or data source ID) |
↳ entity_type | string | Entity type: page, database, block, comment, or data_source |
data | object | |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Property IDs updated as part of the event, when provided by Notion |
↳ parent | object | |
↳ id | string | Parent page, database, workspace (space), or block ID |
↳ parent_type | string | Parent type: page, database, block, workspace, or space |
Notion Webhook (All Events)
Trigger workflow on any Notion webhook event
Configuration and outputs
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | |
↳ id | string | Entity ID (page, database, block, comment, or data source ID) |
↳ entity_type | string | Entity type: page, database, block, comment, or data_source |
data | object | |
↳ parent | object | |
↳ id | string | Parent entity ID, when provided by Notion |
↳ parent_type | string | Parent type (page, database, block, workspace, space, …), when present |
↳ page_id | string | Page ID related to the event, when present |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Updated properties included with the event, when provided by Notion |