- Category: notes
- Auth: OAUTH2, API_KEY
- Composio-managed OAuth available? Yes
- Tools: 60
- Triggers: 8
- Slug:
NOTION - Version: 20261101_00
Frequently Asked Questions
Why do Notion operations show "Composio" instead of the user's name?
Why do Notion operations show "Composio" instead of the user's name?
How do I grant access to more Notion pages?
How do I grant access to more Notion pages?
Does Notion use OAuth scopes?
Does Notion use OAuth scopes?
How does Notion's access model work?
How does Notion's access model work?
Reasons for Notion Connection expiry
Reasons for Notion Connection expiry
- The user disconnects the integration from Notion. Notion documents that OAuth-installed public connections appear under
Settings->Connectionsand can be disconnected from the workspace. If a user removes the Composio-managed or custom Notion app there, the existing token set should be treated as revoked, and the user should reconnect Notion. See Notion’s official guide to adding and managing workspace connections. - The same Notion user connects again through the same Notion app. When a Notion user connects to a Notion app, Notion issues a new
access_tokenandrefresh_tokenpair for that connection. If the same user connects to the same Notion app again, whether it is Composio-managed or custom, Notion can issue a new token pair and invalidate the olderrefresh_token. The olderaccess_tokenmay continue working for some time, but once it expires, the older connection can no longer refresh and should be treated as expired. To avoid this, keep one active Notion connection per real user for a given Notion app, reuse that existing connection in your product, and avoid asking users to reconnect repeatedly. For production Notion integrations, we strongly recommend using your own Notion app so your users’ tokens are isolated to your product. Follow the Notion OAuth setup guide.
How do I set up the Notion webhook ingress endpoint?
How do I set up the Notion webhook ingress endpoint?
Create the endpoint
Python
TypeScript
API
Complete Notion verification
Save the returnedid and webhook_url. Paste webhook_url into your Notion integration’s Webhook settings. Notion sends a verification token to that URL.Replace we_123 with the saved endpoint ID and read the token:Python
TypeScript
API
Notion database trigger fires for new pages, not updates
Notion database trigger fires for new pages, not updates
Tools
Add multiple content blocks (bulk, user-friendly)
Add multiple content blocks (bulk, user-friendly)
NOTION_ADD_MULTIPLE_PAGE_CONTENTBulk-add content blocks as children of a Notion page or supported parent block, optionally after an existing child. Accepts simplified or full block formats and parses markdown in simplified text; long text handling varies by format, and simplified text segments may be truncated.Input Parameters
code link). Valid block_property values: paragraph, heading_1-3, callout, to_do, toggle, quote, bulleted/numbered_list_item, divider. NOTE: ‘code’ and ‘table’ blocks require full Notion format with nested children/properties. ‘divider’ blocks don’t require content. ⚠️ UNSUPPORTED: child_database (use NOTION_CREATE_DATABASE), child_page (use NOTION_CREATE_NOTION_PAGE), link_preview (read-only).Output
Add single content block to Notion page (Deprecated)
Add single content block to Notion page (Deprecated)
NOTION_ADD_PAGE_CONTENTAdds content to a Notion page or parent block using simplified content or a full block object, optionally after an existing child. Notion limits rich-text content to 2,000 characters per text object; the integration needs access and insert-content capability. DEPRECATED: Use add_multiple_page_content for bulk operations.Input Parameters
Output
Append raw Notion blocks (advanced API)
Append raw Notion blocks (advanced API)
NOTION_APPEND_BLOCK_CHILDRENAppends raw Notion blocks to a parent page or block, at the end or after an existing child. Oversized text in supported top-level text blocks is split into rich-text items within the same block. DEPRECATED: Use NOTION_APPEND_TEXT_BLOCKS, NOTION_APPEND_TASK_BLOCKS, NOTION_APPEND_CODE_BLOCKS, NOTION_APPEND_MEDIA_BLOCKS, NOTION_APPEND_LAYOUT_BLOCKS, or NOTION_APPEND_TABLE_BLOCKS instead.Input Parameters
Output
Append code blocks (code, quote, equation)
Append code blocks (code, quote, equation)
NOTION_APPEND_CODE_BLOCKSAppend code and technical blocks (code, quote, equation) to a Notion page. Use for: - Code snippets and programming examples (code) - Citations and highlighted quotes (quote) - Mathematical formulas and equations (equation) Supported block types: - code: Code with syntax highlighting (70+ languages including Python, JavaScript, Go, Rust, etc.) - quote: Block quotes for citations - equation: LaTeX/KaTeX mathematical expressions ⚠️ Code content is limited to 2000 characters per text.content field. For longer code, split into multiple code blocks. For other block types, use specialized actions: - append_text_blocks: paragraphs, headings, lists - append_task_blocks: to-do, toggle, callout - append_media_blocks: image, video, audio, files - append_layout_blocks: divider, columns, TOC - append_table_blocks: tablesInput Parameters
Output
Append layout blocks (divider, TOC, columns)
Append layout blocks (divider, TOC, columns)
NOTION_APPEND_LAYOUT_BLOCKSAppend layout blocks (divider, TOC, breadcrumb, columns) to a Notion page. Supported types: - divider: Horizontal line separator - table_of_contents: Auto-generated from headings - breadcrumb: Page hierarchy navigation - column_list: Multi-column layout (requires 2+ columns, each with 1+ child block) For multi-column layouts, create column_list with column children in one request. Each column must contain at least 1 child block. For other blocks, use: append_text_blocks, append_task_blocks, append_code_blocks, append_media_blocks, or append_table_blocks.Input Parameters
Output
Append media blocks (image, video, audio, files)
Append media blocks (image, video, audio, files)
NOTION_APPEND_MEDIA_BLOCKSAppend media blocks (image, video, audio, file, pdf, embed, bookmark) to a Notion page. Use for: - Images and screenshots (image) - YouTube/Vimeo videos or direct video URLs (video) - Audio files and podcasts (audio) - File downloads (file) - PDF documents (pdf) - Embedded content from Twitter, Figma, CodePen, etc. (embed) - Link previews with metadata (bookmark) All media blocks require external URLs. For other block types, use specialized actions: - append_text_blocks: paragraphs, headings, lists - append_task_blocks: to-do, toggle, callout - append_code_blocks: code, quote, equation - append_layout_blocks: divider, columns, TOC - append_table_blocks: tablesInput Parameters
Output
Append table blocks
Append table blocks
NOTION_APPEND_TABLE_BLOCKSAppend table blocks to a Notion page. Use for structured tabular data like spreadsheets, comparison charts, and status trackers. Example: { “table_width”: 3, “has_column_header”: true, “rows”: [ {“cells”: [[{“type”: “text”, “text”: {“content”: “Col1”}}], […], […]]} ] } ⚠️ Cell content limited to 2000 chars per text.content field.Input Parameters
Output
Append task blocks (to-do, toggle, callout)
Append task blocks (to-do, toggle, callout)
NOTION_APPEND_TASK_BLOCKSAppend to-do, toggle, and callout blocks to a Notion page or block that supports children. Text content is limited to 2,000 characters per text item, with at most 100 blocks per request.Input Parameters
Output
Append text blocks (paragraphs, headings, lists)
Append text blocks (paragraphs, headings, lists)
NOTION_APPEND_TEXT_BLOCKSAppend text blocks (paragraphs, headings, lists) to a Notion page. This is the most commonly used action for adding content to Notion. Use for: documentation, notes, articles, outlines, lists. Supported block types: - paragraph: Regular text - heading_1, heading_2, heading_3: Section headers - bulleted_list_item: Bullet points - numbered_list_item: Numbered lists ⚠️ Text content is limited to 2000 characters per text.content field. For other block types, use specialized actions: - append_task_blocks: to-do, toggle, callout - append_code_blocks: code, quote, equation - append_media_blocks: image, video, audio, files - append_layout_blocks: divider, columns, TOC - append_table_blocks: tablesInput Parameters
Output
Archive Notion Page
Archive Notion Page
NOTION_ARCHIVE_NOTION_PAGEArchives (moves to trash) or unarchives (restores from trash) a specified Notion page. Limitation: Workspace-level pages (top-level pages with no parent page or database) cannot be archived via the API and must be archived manually in the Notion UI.Input Parameters
true to move the page to trash (archive), or false to restore it from trash (unarchive). Defaults to true.Output
Create comment
Create comment
NOTION_CREATE_COMMENTAdds a comment to a Notion page (via parent_page_id) OR to an existing discussion thread (via discussion_id); cannot create new discussion threads on specific blocks (inline comments).Input Parameters
parent_page_id is not provided. Must be a valid UUID (32 hex characters with or without hyphens).discussion_id is not provided. Must be a valid UUID (32 hex characters with or without hyphens). Page IDs can be obtained using other Notion actions that fetch page details or list pages.Output
Create Notion Database
Create Notion Database
NOTION_CREATE_DATABASECreates a new Notion database as a subpage under a specified parent page with a defined properties schema. IMPORTANT NOTES: - The parent page MUST be shared with your integration, otherwise you’ll get a 404 error - If you encounter conflict errors (409), retry the request as Notion may experience temporary save conflicts - For relation properties, you MUST provide the database_id of the related database - Parent ID must be a valid UUID format (with or without hyphens), not a template variable Use this action exclusively for creating new databases.Input Parameters
Output
Create Notion file upload
Create Notion file upload
NOTION_CREATE_FILE_UPLOADCreates a Notion FileUpload object for a direct, multipart, or external URL upload. Direct uploads require subsequent steps to send file contents and attach the uploaded file.Input Parameters
Output
Create Notion page
Create Notion page
NOTION_CREATE_NOTION_PAGECreates a new page in a Notion workspace under a specified parent page or database. Supports creating pages with markdown content using the native markdown parameter, or as an empty page that can be populated later. PREREQUISITES: - Parent page/database must exist and be accessible in your Notion workspace - Use search_pages or list_databases first to obtain valid parent IDs LIMITATIONS: - Cannot create root-level pages (must have a parent) - May encounter conflicts if creating pages too quickly - Title-based parent search is less reliable than using UUIDs - The markdown parameter is mutually exclusive with children/content parametersInput Parameters
Output
Create Notion view
Create Notion view
Create Notion view query
Create Notion view query
Delete a block
Delete a block
NOTION_DELETE_BLOCKArchives a Notion block, page, or database by ID, moving it to Trash for possible later restoration. The connection requires update content capability; an archived ancestor may need to be restored before a descendant can be archived.Input Parameters
NOTION_FETCH_DATA.Output
Delete Notion view
Delete Notion view
Delete Notion view query
Delete Notion view query
Duplicate page
Duplicate page
NOTION_DUPLICATE_PAGEDuplicates a Notion page under a specified parent page or database, copying supported content and writable properties. Page parents receive only the title property; some blocks and properties are skipped, block retrieval may be incomplete, and failure can leave a partial copy.Input Parameters
page_id.Output
Fetch All Notion Block Contents
Fetch All Notion Block Contents
NOTION_FETCH_ALL_BLOCK_CONTENTSFetches child blocks of a Notion block or page across result pages, with optional recursive expansion. Recursive results may be partial due to depth or block limits or inaccessible nested blocks; limit information is returned when recursion is used.Input Parameters
Output
Fetch Notion Block Children
Fetch Notion Block Children
NOTION_FETCH_BLOCK_CONTENTSRetrieves a paginated list of direct child blocks for a Notion block or page. Use returned block IDs to access nested content; for an unsupported block-type error, the result is an empty list with an explanatory message.Input Parameters
Output
Fetch Notion block metadata
Fetch Notion block metadata
NOTION_FETCH_BLOCK_METADATAFetches metadata for a Notion block (including pages, which are special blocks) using its UUID. Returns block type, properties, and basic info but not child content. Prerequisites: 1) Block/page must be shared with your integration, 2) Use valid block_id from API responses (not URLs). For child blocks, use fetch_block_contents instead. Common 404 errors mean the block isn’t accessible to your integration.Input Parameters
Output
Fetch comments
Fetch comments
NOTION_FETCH_COMMENTSFetches a page of unresolved comments for a specified Notion block or page ID. The block or page must be shared with the integration, which must have Read comments capability enabled.Input Parameters
NOTION_SEARCH_NOTION_PAGE action.NOTION_FETCH_DATA action.Output
Fetch Notion Data
Fetch Notion Data
NOTION_FETCH_DATASearch accessible Notion pages and/or databases by title or list them without a query. Returns one page of results with simplified IDs, titles and types, plus a cursor when more results are available; simplified titles use only the first rich-text segment.Input Parameters
Output
Fetch Database
Fetch Database
NOTION_FETCH_DATABASEFetches a Notion database’s structural metadata (properties, title, etc.) via its database_id, not the data entries; database_id must reference an existing database.Input Parameters
Output
Fetch database row
Fetch database row
NOTION_FETCH_ROWRetrieves a Notion database row’s properties and metadata; use fetch_block_contents for page content blocks.Input Parameters
Output
Get About Me (Deprecated)
Get About Me (Deprecated)
Get about user
Get about user
NOTION_GET_ABOUT_USERRetrieves detailed information about a specific Notion user, such as their name, avatar, and email, based on their unique user ID.Input Parameters
Output
Get page markdown
Get page markdown
NOTION_GET_PAGE_MARKDOWNRetrieve a Notion page as Notion-flavored Markdown in a single API call without recursive block-children fetching. The response indicates whether content was truncated and identifies blocks that could not be rendered.Input Parameters
Output
Get page property
Get page property
NOTION_GET_PAGE_PROPERTY_ACTIONCall this to get a specific property from a Notion page when you have a valid page_id and property_id; handles pagination for properties returning multiple items.Input Parameters
has_more: true, provide the next_cursor value here to fetch the subsequent set of items. Omit if fetching the first page.Output
Get plugin
Get plugin
Get Notion view query results
Get Notion view query results
Insert row database
Insert row database
NOTION_INSERT_ROW_DATABASECreates a page (row) in a specified Notion database with optional properties and child blocks. The database must be shared with the integration and cannot have multiple data sources; long child-block text segments may be truncated, and additional blocks are appended after page creation.Input Parameters
name (exact property name, case-sensitive), type (property data type), and value (string-formatted value). Property names AND types are CASE-SENSITIVE and must match your Notion database schema exactly. Each database has exactly ONE ‘title’ type property; all other text properties use ‘rich_text’. Use NOTION_FETCH_DATA with fetch_type=‘databases’ to find exact property names and types. CORRECT FORMAT (list of property objects): [ {“name”: “Task Name”, “type”: “title”, “value”: “Finalize Q3 report”}, {“name”: “Priority”, “type”: “select”, “value”: “High”}, {“name”: “Tags”, “type”: “multi_select”, “value”: “Work,Personal”}, {“name”: “Due Date”, “type”: “date”, “value”: “2024-06-01T12:00:00.000-04:00”}, {“name”: “Completed”, “type”: “checkbox”, “value”: “False”} ] INCORRECT FORMAT (dict - causes validation error): {“Task Name”: “value”, “Priority”: “High”} ‘status’ vs ‘select’ TYPE CONFUSION: - Dropdown lists use type=‘select’ - even if the property is NAMED ‘Status’. - The ‘status’ type is a special Notion property with workflow groups (‘To-do’, ‘In progress’, ‘Complete’). - Use NOTION_FETCH_DATA to verify the actual type in your database schema. PROPERTY TYPE ERRORS: - ‘X is not a property that exists’: Check schema - wrong property name or wrong type. - ‘X is expected to be Y’: Wrong type specified - use the type shown in the error. Value formatting rules by type: - title / rich_text: Plain text string (max 2000 chars). - number: String of a number (e.g., “23.4”). - select: Single option name. Commas NOT allowed - use ‘multi_select’ for multiple values. - multi_select: Comma-separated option names (e.g., “Work,Personal”). Options must exist in schema. - date: ISO 8601. Single: “2024-06-01T12:00:00.000-04:00”. Range: “start/end” separated by ”/”. - people: Comma-separated Notion user IDs. - relation: Comma-separated page UUIDs (NOT text/titles). Use NOTION_QUERY_DATABASE to get page IDs. - checkbox: “True” or “False”. - url: Valid URL string. - files: Comma-separated URLs. - email: Valid email string. - phone_number: Phone number string. Only use if database property type is ‘Phone’.NOTION_FETCH_DATA action to find available database IDs that are already shared with your integration.NotionRichText objects defining content blocks (e.g., paragraphs, headings, media) to append to the new page’s body. Accepts either a list of objects OR a JSON-encoded string representing a list. If omitted, the page body will be empty. Supported block types: paragraph, heading_1, heading_2, heading_3, callout, to_do, toggle, quote, bulleted_list_item, numbered_list_item, divider, image, video, file. Media blocks (image, video, file): Require the link field with an external URL. The Notion API does not support uploading files directly - you must provide publicly accessible URLs. Note: Notion API limits children to 100 blocks per request. If more than 100 blocks are provided, the action will automatically create the page with the first 100 blocks and then append remaining blocks in subsequent API calls.Output
Insert Row From Natural Language
Insert Row From Natural Language
NOTION_INSERT_ROW_FROM_NLCreates a new row (page) in a Notion database from a natural language description. Fetches the database schema at runtime, uses an LLM to generate the correctly-formatted property payload, and creates the page.Input Parameters
Output
List data source templates
List data source templates
NOTION_LIST_DATA_SOURCE_TEMPLATESLists a page of accessible templates for a Notion data source, including their IDs and names. Use the returned cursor to retrieve further pages.Input Parameters
next_cursor value from a previous response to retrieve the next page.Output
List Notion file uploads
List Notion file uploads
NOTION_LIST_FILE_UPLOADSTool to retrieve file uploads for the current bot integration, sorted by most recent first. Use when you need to list all file uploads or paginate through file upload history.Input Parameters
Output
List plugins
List plugins
List users
List users
NOTION_LIST_USERSRetrieves a paginated list of users (excluding guests) from the Notion workspace; the number of users returned per page may be less than the requested page_size.Input Parameters
Output
List Notion views
List Notion views
Move Page
Move Page
NOTION_MOVE_PAGEMoves a Notion page to a new parent page or database data source. For a database destination, provide the data source ID.Input Parameters
Output
Query database
Query database
NOTION_QUERY_DATABASEQuery a shared Notion database for paginated entries, with sorting by database properties or page timestamps. Supply a database UUID and use the returned cursor to retrieve further results.Input Parameters
Output
Query database with filter
Query database with filter
NOTION_QUERY_DATABASE_WITH_FILTERTool to query a Notion database with server-side filtering, sorting, and pagination. Use when you need to retrieve a subset of rows by property, date, status, or other conditions.Input Parameters
next_cursor for fetching the next page. Use the exact cursor value returned by Notion.Output
Query data source
Query data source
NOTION_QUERY_DATA_SOURCEQuery a Notion data source for pages or child data sources using filters, sorts, and optional property selection. Results support cursor pagination, with a requested page size of 1 to 100.Input Parameters
filter_properties[] query parameter.Output
Replace page content (with backup)
Replace page content (with backup)
NOTION_REPLACE_PAGE_CONTENTReplaces a page’s child blocks by optionally backing up current content, archiving existing children, and appending new children in batches. The workflow is not atomic and failures can leave partial changes; backups omit some block types and nested content.Input Parameters
Output
Retrieve Comment
Retrieve Comment
Retrieve Database Property
Retrieve Database Property
NOTION_RETRIEVE_DATABASE_PROPERTYTool to retrieve a specific property object of a Notion database. Use when you need to get details about a single database column/property.Input Parameters
Output
Retrieve Notion file upload
Retrieve Notion file upload
Retrieve page
Retrieve page
NOTION_RETRIEVE_PAGERetrieve a Notion page’s properties and metadata by page ID, rather than its block content. The input must be a UUID, not a full page URL.Input Parameters
Output
Retrieve Notion view
Retrieve Notion view
Search Notion pages and databases
Search Notion pages and databases
NOTION_SEARCH_NOTION_PAGESearch Notion pages and databases by title, with an object-type filter that defaults to pages. Search indexing can lag and results may be incomplete; an empty query can help find accessible items, and optional client-side property filtering reduces page response size.Input Parameters
timestamp is provided. Valid values are ascending or descending.last_edited_time. If provided, direction must also be specified.next_cursor field. Must be exactly as returned by the API - do not pass page IDs, database IDs, or any other identifiers. If None, empty, or invalid, results start from the beginning.object, which filters by the type specified in filter_value. Defaults to object.Output
Send file upload
Send file upload
NOTION_SEND_FILE_UPLOADTool to transmit file contents to Notion for a file upload object. Use after creating a file upload object to send the actual file data.Input Parameters
Output
Update block
Update block
NOTION_UPDATE_BLOCKUpdates existing Notion block’s text content. ⚠️ CRITICAL: Content limited to 2000 chars. Cannot change block type or archive blocks. Content exceeding 2000 chars will fail with validation error. For longer content, split across multiple blocks using add_multiple_page_content.Input Parameters
NOTION_FETCH_DATA to get page IDs and titles.Output
Update Page
Update Page
NOTION_UPDATE_PAGEUpdate page properties, icon, cover, or archive status. IMPORTANT: Property names are workspace-specific and case-sensitive. Use NOTION_FETCH_ROW or NOTION_FETCH_DATABASE first to discover exact property names and valid select/status options. Common errors: - “X is not a property that exists”: Discover properties with NOTION_FETCH_ROW - “Invalid status option”: Check valid options with NOTION_FETCH_DATABASE - “should be defined”: Wrap values: {‘Field’: {‘type’: value}} Property formats: title/rich_text use {‘text’: {‘content’: ‘value’}}, select/status use {‘name’: ‘option’}Input Parameters
Output
Update page markdown
Update page markdown
Update Database Row (Page)
Update Database Row (Page)
NOTION_UPDATE_ROW_DATABASEUpdates a specific row/page within a Notion database by its page UUID (row_id). IMPORTANT CLARIFICATION: This action updates INDIVIDUAL ROWS (pages) in a database, NOT the database structure. - To update a ROW/PAGE: Use THIS action with row_id (the page UUID) - To update DATABASE SCHEMA (columns, properties, title): Use NOTION_UPDATE_SCHEMA_DATABASE with database_id REQUIRED: row_id is MANDATORY. This is the UUID of the specific page/row to update. Do NOT pass database_id to this action - that parameter does not exist here. Common issues: (1) Use UUID from page URL, not the full URL (2) Ensure page is shared with integration (3) Match property names exactly as in database (4) Use ‘status’ type for Status properties, not ‘select’ (5) Retry on 409 Conflict errors (concurrent updates) Supports updating properties, icon, cover, or archiving the row.Input Parameters
Output
Update database schema
Update database schema
NOTION_UPDATE_SCHEMA_DATABASEUpdates an existing Notion database’s schema including title, description, and/or properties (columns). IMPORTANT NOTES: - At least one update (title, description, or properties) must be provided - The database must be shared with your integration - Property names are case-sensitive and must match exactly - When changing a property to ‘relation’ type, you MUST provide the database_id of the target database - Removing properties will permanently delete that column and its data - Use NOTION_FETCH_DATA first to get the exact property names and database structure Common errors: - ‘database_id’ missing: Ensure you’re passing the database_id parameter (not page_id) - ‘data_source_id’ undefined: When changing to relation type, database_id is required in PropertySchemaUpdate - Property name mismatch: Names must match exactly including case and special charactersInput Parameters
Output
Upsert database rows
Upsert database rows
NOTION_UPSERT_ROW_DATABASEUpserts Notion database rows in bulk by querying a filter for each item, then creating a row if none is returned or updating a match. Only the first query page is examined; multiple matches can update the first or produce an error, with per-item results.Input Parameters
Output
Triggers
Comment Created
Comment Created
Database Created
Database Created
NOTION_DATABASE_CREATEDType: webhookTriggers when a new Notion database (the container) is created.A database is the post-2025-09-03 container that holds one or more data sources. This trigger fires for the container’s creation event (database.created), distinct from NOTION_DATASOURCE_CREATED which fires when a new data source is added to an existing database.Most customers calling Notion’s POST /v1/databases (the legacy API) or creating a database via the Notion UI will see this event. Adding a new data source to an existing database fires data_source.created instead — use NOTION_DATASOURCE_CREATED for that.Notion’s payload puts entity.type: "block" (the container is a child_database block in the content tree) and entity.id is the database id.Payload
Data Source Created
Data Source Created
NOTION_DATASOURCE_CREATEDType: webhookTriggers when a new Notion data source is created.Fires workspace-wide. The payload’s data.parent carries the data source’s tree parent (typically the teamspace) for downstream filtering.A single template-based database creation can fire multiple data_source.created events at once — one per data source the template instantiates.Payload
Data Source Schema Updated
Data Source Schema Updated
NOTION_DATASOURCE_SCHEMA_UPDATEDType: webhookTriggers when a Notion data source’s schema is updated.Fires on column add / remove / rename. Payload includes data.updated_properties: [{id, name, action}] so consumers can discriminate the kind of change downstream.Optional data_source_id filter scopes to schema changes on a single data source. When omitted, fires for any schema change in the workspace the integration has access to.Note: adding a column also fires page.properties_updated once per existing row in the data source. Customers wanting a single structural-change signal should use this trigger.Configuration
Payload
Page Content Updated
Page Content Updated
NOTION_PAGE_CONTENT_UPDATEDType: webhookTriggers when the body content of a Notion page is updated.Customer optionally scopes with at most one of:- data_source_id: any row in this data source
- page_id: this specific page
- parent_page_id: any page whose immediate parent is this page
Configuration
Page Created
Page Created
NOTION_PAGE_CREATEDType: webhookTriggers when a new Notion page is created.Customer optionally scopes with at most one of:- data_source_id: new row in this data source
- parent_page_id: new sub-page under this page (immediate parent only)
Configuration
Payload
Page Properties Updated
Page Properties Updated
NOTION_PAGE_PROPERTIES_UPDATEDType: webhookTriggers when properties of a Notion page are updated.Customer optionally scopes with at most one of:- data_source_id: any row in this data source
- page_id: this specific page
- parent_page_id: any page whose immediate parent is this page
data.updated_properties (array of property IDs) to filter downstream.Configuration
Payload
View Created
View Created
NOTION_VIEW_CREATEDType: webhookTriggers when a new Notion view is created.Fires workspace-wide. The payload includes data.view_type (table, board, gallery, calendar, list, timeline, gantt) and data.parent pointing at the view’s tree parent (typically the teamspace), so customers can filter downstream.
NOTION_COMMENT_CREATEDType: webhookTriggers when a new comment is created in Notion.Optionalpage_idfilter scopes to comments on a specific page. When omitted, fires for any new comment in the workspace the integration has access to.Requires the ‘Read comments’ capability on the Notion integration. If a connection was authorized before that capability was enabled, the user must re-authorize the connection for comment events to flow.Configuration
Payload