Notion

Add Notion Page Comment

Adds a comment to a Notion page.

Unverified

What the model is told

Add a comment to an existing Notion page using its page ID. Confirm the wording with the customer if it is something they said. Tell them the comment has been added.

Request

POSThttps://api.notion.com/v1/comments

Headers

  • Content-Typeapplication/json
  • AuthorizationBearer YOUR_NOTION_TOKEN
  • Notion-Version2026-03-11

Body

{
  "parent": {
    "page_id": "{{pageId}}"
  },
  "rich_text": [
    {
      "text": {
        "content": "{{comment}}"
      }
    }
  ]
}

Parameters

  • pageId stringThe ID of the Notion page to comment on.
  • comment stringThe comment text.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "b9d45715-2810-4a0b-84ab-e7fa49538790",
    "type": "HTTP_REQUEST",
    "label": "Add Notion Page Comment",
    "name": "add_notion_page_comment",
    "customName": false,
    "description": "Add a comment to an existing Notion page using its page ID. Confirm the wording with the customer if it is something they said. Tell them the comment has been added.",
    "parameters": [
      {
        "name": "pageId",
        "type": "string",
        "description": "The ID of the Notion page to comment on."
      },
      {
        "name": "comment",
        "type": "string",
        "description": "The comment text."
      }
    ],
    "config": {
      "endpoint": {
        "method": "POST",
        "url": "https://api.notion.com/v1/comments"
      },
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        },
        {
          "name": "Authorization",
          "value": "Bearer YOUR_NOTION_TOKEN"
        },
        {
          "name": "Notion-Version",
          "value": "2026-03-11"
        }
      ],
      "body": "{\n  \"parent\": {\n    \"page_id\": \"{{pageId}}\"\n  },\n  \"rich_text\": [\n    {\n      \"text\": {\n        \"content\": \"{{comment}}\"\n      }\n    }\n  ]\n}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.