View as Markdown
Twist icon

Twist ACTION

Add Comment

Adds a new comment to a thread.
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Twist account once, then configure and run Add 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: "twist-add-comment",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    twist: { authProvisionId: "apn_xxxxxxx" },
    thread_id: "Thread id",
    content: "Content",
  },
})

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.

Add Comment inputs
Property Type Description
thread_id Thread id string
The id of the thread to the add the comment on.
Required
content Content string
The content of the new comment. Mentions can be used as [Name](twist-mention://user_id) for users or [Group name](twist-group-mention://group_id) for groups. Check limits for size restrictions for the content.
Required
attachments Attachments any
List of attachments to the new comment. It must follow the JSON format returned by attachment#upload.
Optional
actions Actions string
List of action to the new comment. More information about the format of the object available at the add an action button submenu.
Optional
direct_mentions Direct mentions any
The users that are directly mentioned.
Optional
direct_group_mentions Direct group mentions any
The groups that are directly mentioned.
Optional
recipients Recipients any
An array of users (e.g. recipients: [10000, 10001]) to notify. It also accepts the strings EVERYONE or EVERYONE_IN_THREAD, which notifies everyone in the workspace or everyone mentioned in previous posts of this thread. If not provided, EVERYONE_IN_THREAD will be used.
Optional
groups Groups any
The groups that will be notified.
Optional
temp_id Temp id string
The temporary id of the comment.
Optional
mark_thread_position Mark thread position boolean
By default, the position of the thread is marked.
Optional
send_as_integration Send as integration boolean
Displays the integration as the comment creator.
Optional

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
twist-add-comment
Version
0.2.3
App
Twist
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes