View as Markdown
Notion icon

Notion ACTION

Create Comment

Add a comment to a Notion page, or reply to an existing discussion thread. Provide either a page ID/URL (use Search to resolve a page name) or a discussion ID — not both. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Notion account once, then configure and run Create Comment from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "notion-create-comment",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    notion: { authProvisionId: "apn_xxxxxxx" },
    pageId: "Page ID or URL",
    discussionId: "Discussion ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Comment inputs
Property Type Description
pageId Page ID or URL string
The ID (or Notion URL) of the page to comment on. Use Search to resolve a page name into an ID. Provide this or a Discussion ID.
Optional
discussionId Discussion ID string
The ID of an existing discussion thread to reply to — the discussion_id Notion returns for a thread, a UUID like f1c5e8a0-.... Provide this or a Page ID.
Optional
comment Comment string
The comment text.
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
notion-create-comment
Version
0.1.1
App
Notion
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes