Notion

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

Input

Parameter	Type	Required	Description
`pageId`	string	Yes	The UUID of the Notion page to append content to
`content`	string	Yes	The content to append to the page

Output

Parameter	Type	Description
`appended`	boolean	Whether content was successfully appended

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

Input

Parameter	Type	Required	Description
`pageId`	string	Yes	The UUID of the Notion page to update
`properties`	json	Yes	JSON object of properties to update

Output

Parameter	Type	Description
`id`	string	Page UUID
`url`	string	Notion page URL
`last_edited_time`	string	ISO 8601 last edit timestamp
`title`	string	Page title

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)

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

Notion

On this page