# Notion Manage Notion pages 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. ## Usage Instructions Integrate with Notion into the workflow. Can read page, read database, create page, create database, append content, query database, and search workspace. ## Tools ### `notion_read` Read content from a Notion page #### 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 | ### `notion_read_database` Read database information and structure from Notion #### 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_write` Append content to a Notion page #### 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_create_page` Create a new page in Notion #### 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_update_page` Update properties of a Notion page #### 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 | ### `notion_query_database` Query and filter Notion database entries with advanced filtering #### 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) | #### 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) | | ↳ `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 | ### `notion_search` Search across all pages and databases in Notion workspace #### 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) | #### 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 | ### `notion_create_database` Create a new database in Notion with custom properties #### 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 | ### `notion_add_database_row` Add a new row to a Notion database with specified properties #### 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 | ## Triggers A workflow can start when one of these Notion events occurs. ### Notion Page Created Trigger workflow when a new page is created in Notion Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Page Properties Updated Trigger workflow when page properties are modified in Notion Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Page Content Updated Trigger workflow when page content is changed in Notion Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Page Deleted Trigger workflow when a page is deleted in Notion Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Page Locked Trigger workflow for the Notion page.locked webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Page Moved Trigger workflow for the Notion page.moved webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Page Restored Trigger workflow for the Notion page.undeleted webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Page Unlocked Trigger workflow for the Notion page.unlocked webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Database Created Trigger workflow when a new database is created in Notion Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Database Schema Updated Trigger workflow when a database schema is modified in Notion Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Database Deleted Trigger workflow when a database is deleted in Notion Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Database Content Updated (Legacy) 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. #### Configuration | 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. | #### Output | 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 | ### Notion Database Moved Trigger workflow for the Notion database.moved webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Database Restored Trigger workflow for the Notion database.undeleted webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Data Source Created Trigger workflow for the Notion data\_source.created webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Data Source Schema Updated Trigger workflow for the Notion data\_source.schema\_updated webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Data Source Content Updated Trigger workflow for the Notion data\_source.content\_updated webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Data Source Deleted Trigger workflow for the Notion data\_source.deleted webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Data Source Moved Trigger workflow for the Notion data\_source.moved webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Data Source Restored Trigger workflow for the Notion data\_source.undeleted webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Comment Created Trigger workflow when a comment or suggested edit is added in Notion Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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) | ### Notion Comment Updated Trigger workflow for the Notion comment.updated webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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) | ### Notion Comment Deleted Trigger workflow for the Notion comment.deleted webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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) | ### Notion View Created Trigger workflow for the Notion view\.created webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion View Updated Trigger workflow for the Notion view\.updated webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion View Deleted Trigger workflow for the Notion view\.deleted webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 | ### Notion Webhook (All Events) Trigger workflow on any Notion webhook event Notion sends the event to the webhook URL shown in the block. #### Configuration | 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. | #### Output | 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 |