Twist

Let your agents work in your Twist workspaces — read channels, threads and comments, open threads, reply, send direct messages and keep track of unread threads.

Connection

Authentication: API key (Twist API token).

Sign in to Twist, open the App Console (twist.com/app_console) and create a “General integration”. On the integration’s page, open the OAuth section and copy the test token. It acts as your own Twist account with full scope access: the agent reads and posts exactly what you can, so connect an account that only belongs to the workspaces and channels the agent should see.See Twist’s documentation.

Read actions (10)

Action	Description
`get_thread`	Fetch one thread (title, content, participants, last_obj_index).
`list_channels`	List the channels of a workspace (full channel objects). archived=true returns only archived channels.
`list_comments`	List the comments of a thread (20 by default, up to 500), newest first unless order_by=asc. newer_than_ts / older_than_ts are Unix timestamps passed as strings.
`list_conversation_messages`	List the messages of a direct-message conversation (20 by default, up to 500), newest first unless order_by=asc.
`list_conversations`	List the account’s direct-message conversations in a workspace (20 by default, up to 500), most recently active first.
`list_groups`	List the user groups of a workspace — gives the group ids used for group notifications and mentions.
`list_threads`	List the threads of a channel (20 by default, up to 500), newest activity first unless order_by=asc.
`list_unread_threads`	List the unread threads of the account in a workspace (channel_id, thread_id, obj_index, direct_mention).
`list_workspace_users`	List the members of a workspace (id, name, email, user type) — gives the user ids used for recipients and mentions.
`list_workspaces`	List the workspaces (teams) the account belongs to — gives the workspace_id every other action needs.

Write actions (4)

Action	Description
`add_comment`	Reply in a thread. Arguments: thread_id (integer); content (string, Markdown; mention a user as Name); recipients (optional: array of integer user ids, or the string “EVERYONE_IN_THREAD” (default) or “EVERYONE”); groups, direct_mentions, direct_group_mentions (optional arrays of integer ids).
`create_thread`	Open a new thread in a channel. Arguments: channel_id (integer, from list_channels); title (string, 1 to 300 characters); content (string, Markdown; mention a user as Name); recipients (optional: array of integer user ids, or the string “EVERYONE” — omitted = the channel members, [] = nobody notified); groups, direct_mentions, direct_group_mentions (optional arrays of integer ids).
`mark_thread_read`	Mark a thread as read for the account. Arguments: thread_id (integer); obj_index (integer, index of the last read comment — the obj_index from list_unread_threads or the last_obj_index from get_thread).
`send_conversation_message`	Send a message in an existing direct-message conversation. Arguments: conversation_id (integer, from list_conversations); content (string, Markdown; mention a user as Name); direct_mentions, direct_group_mentions (optional arrays of integer ids).

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: September 2026.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

Connection

Read actions (10)

Write actions (4)

Permissions

​Connection

​Read actions (10)

​Write actions (4)

​Permissions

Connection

Read actions (10)

Write actions (4)

Permissions