Notion - Add Comment

↩ Part of the Notion integration.

Description

This module posts a comment on a Notion page with POST /comments. The parent of the comment is always the page, so the comment shows up in the page’s comment thread, not attached to a specific block.

It is the lightest way to tell a human that something happened: a payment failed, a ticket changed owner, a nightly job finished.

Configuration

Field	Type	Required	Description
`credentials_id`	credentials	Yes	Notion credential
`page_id`	text	Yes	Page id
`text`	textarea	Yes	Comment text

Credentials

This module requires a Notion credential.

Field	Description
`token`	Internal Integration Secret from notion.so/my-integrations
`notion_version`	Optional. Value for the `Notion-Version` header (default `2022-06-28`)

Output

{
  "nextModule": null,
  "data": {
    "object": "comment",
    "id": "2f3a4b5c-6d7e-8f9a-0b1c-2d3e4f5a6b7c",
    "parent": { "type": "page_id", "page_id": "8b9c0d1e-2f3a-4b5c-6d7e-8f9a0b1c2d3e" },
    "created_time": "2026-03-05T09:41:00.000Z",
    "rich_text": [ { "type": "text", "plain_text": "Payment failed, please review." } ]
  },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "8b9c0d1e-2f3a-4b5c-6d7e-8f9a0b1c2d3e",
    "commentId": "2f3a4b5c-6d7e-8f9a-0b1c-2d3e4f5a6b7c",
    "totalMs": 187
  }
}

Usage Example

Warn about a failed payment

{
  "credentials_id": 12,
  "page_id": "{{data.id}}",
  "text": "Payment for invoice {{data.invoice}} failed ({{data.reason}}). Please review before Friday."
}

Confirm an automated step

{
  "credentials_id": 12,
  "page_id": "8b9c0d1e-2f3a-4b5c-6d7e-8f9a0b1c2d3e",
  "text": "Report generated automatically at {{data.timestamp}}."
}

Notes

The comment is created by the integration, so it appears under the integration’s name, not under a user account.
The comment body is plain text. Mentions with @ and rich formatting are not built by this node.
The integration needs comment permission on the page. Check the capabilities of your integration in notion.so/my-integrations, and remember the page still has to be shared with it.
_meta.commentId is the id of the new comment; _meta.id is the id of the page it was posted on.

Notion - Append Content — write in the body of the page instead of the comment thread.
Notion - Update Page — change a status alongside the comment.
Notion - Get Page — get the page id you need to comment on.