create-thread
Create a new thread in a Twist workspace channel by providing the channel ID, title, and content. Optionally notify specific users or groups.
Instructions
Create a new thread in a workspace channel. Requires a channel ID, title, and content. Optionally notify specific users or groups.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | The title of the thread. | |
| groups | No | Optional array of group IDs to notify. Use get-groups to discover group IDs before passing them here. | |
| content | Yes | The content/body of the thread. | |
| channelId | Yes | The ID of the channel to create the thread in. | |
| recipients | No | Optional array of user IDs to notify. If omitted, Twist defaults to notifying all current members of the channel (equivalent to the API's "EVERYONE" default). Note: workspace users who have not joined this channel will not be notified — add their IDs explicitly if you want to reach them. | |
| displayInInbox | No | If true, unarchives the thread after creation so it appears in the author's Inbox. Defaults to false. Can also be enabled for all calls by setting the TWIST_CREATE_THREAD_DISPLAY_IN_INBOX=true environment variable (local MCP only). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| title | Yes | ||
| groups | No | ||
| content | Yes | ||
| created | Yes | ||
| creator | Yes | ||
| success | Yes | ||
| threadId | Yes | ||
| channelId | Yes | ||
| threadUrl | Yes | ||
| recipients | No | ||
| workspaceId | Yes |