The Notion tool integration enables your agents to read, create, and manage Notion pages and databases directly within your workflows. This allows you to automate the retrieval and updating of structured content, notes, documents, and more from your Notion workspace.
With the Notion tool, you can:
- Read pages or databases: Extract rich content or metadata from specified Notion pages or entire databases
- Create new content: Programmatically create new pages or databases for dynamic content generation
- Append content: Add new blocks or properties to existing pages and databases
- Query databases: Run advanced filters and searches on structured Notion data for custom workflows
- Search your workspace: Locate pages and databases across your Notion workspace automatically
This tool is ideal for scenarios where agents need to synchronize information, generate reports, or maintain structured notes within Notion. By bringing Notion's capabilities into automated workflows, you empower your agents to interface with knowledge, documentation, and project management data programmatically and seamlessly.
Integrate with Notion into the workflow. Can read page, read database, create page, create database, append content, query database, and search workspace.
Read content from a Notion page
| Parameter | Type | Required | Description |
|---|
pageId | string | Yes | The UUID of the Notion page to read |
| 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 database information and structure from Notion
| Parameter | Type | Required | Description |
|---|
databaseId | string | Yes | The UUID of the Notion database to read |
| 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 |
Append content to a Notion page
| 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 |
| Parameter | Type | Description |
|---|
appended | boolean | Whether content was successfully appended |
Create a new page in Notion
| 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 |
| 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 |
Update properties of a Notion page
| Parameter | Type | Required | Description |
|---|
pageId | string | Yes | The UUID of the Notion page to update |
properties | json | Yes | JSON object of properties to update |
| 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 and filter Notion database entries with advanced filtering
| 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) |
| 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) |
↳ url | string | Authenticated URL valid for one hour |
↳ expiry_time | string | ISO 8601 timestamp when URL expires |
↳ 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 (never expires) |
↳ 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 across all pages and databases in Notion workspace
| 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) |
| 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 a new database in Notion with custom properties
| 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) |
| 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 a new row to a Notion database with specified properties
| 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"}}}) |
| 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 |
A workflow can start when one of these Notion events occurs.
Trigger workflow when a new page is created in Notion
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Data source that owns the page, when provided by Notion |
Trigger workflow when page properties are modified in Notion
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Data source that owns the page, when provided by Notion |
Trigger workflow when page content is changed in Notion
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Data source that owns the page, when provided by Notion |
Trigger workflow when a page is deleted in Notion
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Data source that owns the page, when provided by Notion |
Trigger workflow for the Notion page.locked webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Data source that owns the page, when provided by Notion |
Trigger workflow for the Notion page.moved webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Data source that owns the page, when provided by Notion |
Trigger workflow for the Notion page.undeleted webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Data source that owns the page, when provided by Notion |
Trigger workflow for the Notion page.unlocked webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Data source that owns the page, when provided by Notion |
Trigger workflow when a new database is created in Notion
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow when a database schema is modified in Notion
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow when a database is deleted in Notion
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow for the Notion database.content_updated or data_source.content_updated webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow for the Notion database.moved webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow for the Notion database.undeleted webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow for the Notion data_source.created webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow for the Notion data_source.schema_updated webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow for the Notion data_source.content_updated webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow for the Notion data_source.deleted webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow for the Notion data_source.moved webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow for the Notion data_source.undeleted webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
Trigger workflow when a comment or suggested edit is added in Notion
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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) |
Trigger workflow for the Notion comment.updated webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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) |
Trigger workflow for the Notion comment.deleted webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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) |
Trigger workflow for the Notion view.created webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
data | object | |
↳ parent | object | |
↳ id | string | Parent database or workspace ID |
↳ parent_type | string | Parent type reported by Notion |
↳ data_source_id | string | Data source that owns the view, when provided by Notion |
↳ view_type | string | Notion view layout type |
↳ updated_fields | array | View fields changed by a view.updated event |
Trigger workflow for the Notion view.updated webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
data | object | |
↳ parent | object | |
↳ id | string | Parent database or workspace ID |
↳ parent_type | string | Parent type reported by Notion |
↳ data_source_id | string | Data source that owns the view, when provided by Notion |
↳ view_type | string | Notion view layout type |
↳ updated_fields | array | View fields changed by a view.updated event |
Trigger workflow for the Notion view.deleted webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
data | object | |
↳ parent | object | |
↳ id | string | Parent database or workspace ID |
↳ parent_type | string | Parent type reported by Notion |
↳ data_source_id | string | Data source that owns the view, when provided by Notion |
↳ view_type | string | Notion view layout type |
↳ updated_fields | array | View fields changed by a view.updated event |
Trigger workflow on any Notion webhook event
Notion sends the event to the webhook URL shown in the block.
| Field | Type | Description |
|---|
| Webhook Secret | text | Automatically captures the verification_token sent by Notion during setup. You can also enter it manually. The same token verifies X-Notion-Signature HMAC headers on subsequent deliveries. |
| Field | 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, data_source, or view |
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 |
↳ data_source_id | string | Parent data source, when provided by Notion |
↳ 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 |
↳ updated_fields | array | View fields changed by a view.updated event, when provided by Notion |
↳ view_type | string | View layout type, when provided by Notion |