Notion + NodeHub

Account permissions

• insert content

Operation limits

• Adds one divider at the end by default, at the start, or after a direct child. A lost response is uncertain and not retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Adds one heading 1 with one plain-text segment of at most 2,000 characters. Position defaults to the end or can specify the start or an existing direct child. Rich formatting and nested blocks are not supported. A lost response is uncertain and not retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Adds one heading 2 with one plain-text segment of at most 2,000 characters. Position defaults to the end or can specify the start or an existing direct child. Rich formatting and nested blocks are not supported. A lost response is uncertain and not retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Adds one heading 3 with one plain-text segment of at most 2,000 characters. Position defaults to the end or can specify the start or an existing direct child. Rich formatting and nested blocks are not supported. A lost response is uncertain and not retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Adds one numbered list item with one plain-text segment of at most 2,000 characters. Position defaults to the end or can specify the start or an existing direct child. Rich formatting and nested blocks are not supported. A lost response is uncertain and not retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Adds one quote with one plain-text segment of at most 2,000 characters. Position defaults to the end or can specify the start or an existing direct child. Rich formatting and nested blocks are not supported. A lost response is uncertain and not retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Adds one bulleted list item with one plain-text segment, at most 2,000 characters, at the end by default, at the start, or after one direct child. Nested items and rich formatting are not supported. A lost response is uncertain and not retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Creates at most twenty first-level blocks and one level of children, with at most one hundred blocks total. Callouts support an emoji icon; rich text supports page, database and user mentions plus inline equations. Image, audio, video, PDF and file blocks can use direct public HTTPS URLs, but NodeHub does not upload files to Notion. Deeper nesting and other mention types are not supported here. A lost response is uncertain and is never resent automatically.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Adds one paragraph, up to 2,000 characters, at the end by default, at the start, or after one direct child. Use bounded iteration for multiple paragraphs. Rich formatting, nesting and moving existing blocks are not supported by this operation.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Adds one to-do with one plain-text segment, at most 2,000 characters, at the end by default, at the start, or after one direct child. Nested blocks and rich formatting are not supported. A lost response is uncertain and not retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert comment

Operation limits

• Posts one plain-text comment, up to 2,000 characters. Inserting comments must be enabled in the Notion connection's Developer portal settings.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content

Operation limits

• Under a page, title is the only supported property. Under a data source, property names and types must match its schema. Append page content in a subsequent step.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• update content

Operation limits

• The old text must match exactly once; Notion rejects missing or ambiguous matches. Child pages and databases cannot be deleted by this action. A lost response leaves the write uncertain and is never retried automatically.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• read content

Operation limits

• A block with children returns only the child marker here. Use Read block children for their content.

Account permissions

• read content

Operation limits

• The parent database must be shared with this integration. A related database must also be shared to expose relation properties.

Account permissions

• read content

Operation limits

• The database is a container. Query its data source ID to read entries. The database must be shared with this integration.

Account permissions

• read content

Operation limits

• Page content is retrieved separately through block children. Properties with many references may require Notion's separate property-item pagination endpoint.

Account permissions

• read content

Operation limits

• Markdown may omit inaccessible or unsupported blocks. Check truncated and unknown_block_ids before treating it as complete. Pass an unknown block ID as pageId to attempt its subtree; inaccessible blocks return 404. Meeting transcripts require includeTranscript=true.

Account permissions

• read user information

Operation limits

• Requires user information capability. The user or guest must belong to the connected workspace. No search by name or email is offered by this endpoint.

Account permissions

• insert content

Operation limits

• The placement block must be an existing direct child of the selected parent. Inserts one plain-text paragraph, up to 2,000 characters. A lost response is uncertain and is never automatically retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• read comment

Operation limits

• Only unresolved comments are returned. Reading comments must be enabled in the Notion connection's Developer portal settings.

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

Account permissions

• read user information

Operation limits

• Requires user information capability. Personal access tokens cannot list workspace users. Guests are not included. One cursor page is returned; Notion does not guarantee sort order.

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

Account permissions

• update content

Operation limits

• Moves the block to trash; it is not permanently deleted. A lost provider response is uncertain and never automatically retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• read content

Operation limits

• Uses the data source ID, not a database ID. The parent database must be shared with the integration. Results retain next_cursor, has_more and request_status; Notion may cap a query at 10,000 matches. Each call returns one cursor page; ordered sorts, archived selection and property projection are available.

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

Account permissions

• read content

Operation limits

• Returns first-level children only. Retrieve each child's children separately when has_children is true, and continue with next_cursor while has_more is true.

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

Account permissions

• read content

Operation limits

• Simple properties return one item; title, rich text, people, relations and rollups can return cursor pages. The property must be visible to the integration. Enter the property name or unencoded ID; NodeHub encodes the path segment.

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

Account permissions

• update content

Operation limits

• Replaces the page body, not its properties. Notion refuses a replacement that would delete child pages or databases. Review the current markdown before replacing it. A lost response leaves the write uncertain and is never retried automatically.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert comment

Operation limits

• The discussion ID must already exist. Inserting comments must be enabled in the Notion connection's Developer portal settings.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• read content

Operation limits

• Returns one cursor page of data sources explicitly shared with the selected integration. Notion search is not guaranteed to be exhaustive or immediately consistent after a title change.

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

Account permissions

• read content

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

Account permissions

• update content

Operation limits

• Only the checked state changes. The selected block must already be a to-do. A lost response is uncertain and not retried.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• update content

Operation limits

• Omitted properties remain unchanged; supplied arrays replace their values. inTrash moves a page to trash or restores it, and does not permanently delete it. A page's parent cannot be changed here.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• update content

Operation limits

• Replaces the paragraph's rich text with one plain-text segment, up to 2,000 characters. Existing styling and links in that paragraph are lost.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Account permissions

• insert content
• file upload

Operation limits

• Uploads one protected file up to 16 MB using Notion's single-part API, then attaches it as a block. The connected integration needs access to the parent page or block.
• A failed or lost response after upload creation can leave an unattached file in Notion. NodeHub never replays this write automatically. File types and size must also satisfy Notion's limits.

A repeated request may repeat the external action. Review the previous result before retrying a write.