Welcome to the Twitter integration docs. Once you connect your Twitter account to Reasoning Stack, your AI agents and workflows can use the following tools to post tweets, manage lists, interact with users, handle DMs, and analyze Twitter data programmatically.
Before accessing any Twitter tools, connect your Twitter account via the App Connection page. Without this, tool calls will fail due to missing authorization.

​
Twitter Tool Categories

​
Tweet Management

  • TWITTER_CREATION_OF_A_POST – Posts a new tweet (text required unless you attach media, poll, card, or quote another tweet).
  • TWITTER_POST_DELETE_BY_POST_ID – Irreversibly deletes a tweet by its ID.
  • TWITTER_RETWEET_POST – Retweets a tweet on behalf of the authenticated user.
  • TWITTER_UNRETWEET_POST – Removes your retweet of a specified tweet.
  • TWITTER_USER_LIKE_POST – Likes a tweet on behalf of the authenticated user.
  • TWITTER_UNLIKE_POST – Removes a like from a tweet.
  • TWITTER_ADD_POST_TO_BOOKMARKS – Bookmarks a tweet for the authenticated user.
  • TWITTER_REMOVE_A_BOOKMARKED_POST – Removes a tweet from your bookmarks.
  • TWITTER_POST_LOOKUP_BY_POST_ID – Fetches details for a specific tweet.
  • TWITTER_POST_LOOKUP_BY_POST_IDS – Fetches details for multiple tweets by ID.
  • TWITTER_RECENT_SEARCH – Searches tweets from the last 7 days.
  • TWITTER_RECENT_SEARCH_COUNTS – Returns counts of recent-search results by time intervals.
  • TWITTER_FULL_ARCHIVE_SEARCH – Searches the full public tweet archive (since March 2006).
  • TWITTER_FULL_ARCHIVE_SEARCH_COUNTS – Returns counts of archive-search results aggregated by time intervals.
  • TWITTER_POSTS_LABEL_STREAM – Opens a real-time stream of tweet label events.
  • TWITTER_POST_USAGE – Retrieves your app’s tweet-usage stats (limits, breakdowns).
  • TWITTER_RETRIEVE_POSTS_FROM_A_SPACE – Retrieves tweets from a specified space (batched).
  • TWITTER_RETRIEVE_POSTS_THAT_QUOTE_A_POST – Retrieves tweets quoting a given tweet.
  • TWITTER_RETRIEVE_POSTS_THAT_REPOST_A_POST – Retrieves retweets of a given tweet.
  • TWITTER_LIST_POSTS_TIMELINE_BY_LIST_ID – Fetches recent tweets from members of a list.
  • TWITTER_LIST_POST_LIKERS – Lists users who liked a specific tweet.
  • TWITTER_GET_POST_RETWEETERS_ACTION – Lists users who retweeted a given tweet.

​
List Management

  • TWITTER_CREATE_LIST – Creates a new, empty list for the authenticated user (name must be unique).
  • TWITTER_DELETE_LIST – Permanently deletes one of your lists by ID.
  • TWITTER_UPDATE_LIST – Updates a list’s name, description, or privacy.
  • TWITTER_ADD_A_LIST_MEMBER – Adds a user to one of your lists.
  • TWITTER_REMOVE_A_LIST_MEMBER – Removes a member from one of your lists.
  • TWITTER_FETCH_LIST_MEMBERS_BY_ID – Lists members of a specified list.
  • TWITTER_LIST_LOOKUP_BY_LIST_ID – Retrieves metadata for a single list.
  • TWITTER_GET_LIST_FOLLOWERS – Lists users who follow a specified list.
  • TWITTER_FOLLOW_A_LIST – Subscribes the authenticated user to a list’s timeline (doesn’t automatically follow members).
  • TWITTER_UNFOLLOW_A_LIST – Unsubscribes the user from a list.
  • TWITTER_PIN_A_LIST – Pins a list to the authenticated user’s profile.
  • TWITTER_UNPIN_A_LIST – Unpins a list from the user’s profile.
  • TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS – Lists all lists a user is a member of.
  • TWITTER_GET_A_USER_S_OWNED_LISTS – Lists all lists created by a given user.
  • TWITTER_GET_A_USER_S_PINNED_LISTS – Lists the lists a user has pinned on their profile.
  • TWITTER_GET_USER_S_FOLLOWED_LISTS – Lists the lists a user follows.

​
User & Follower Management

  • TWITTER_FOLLOW_USER – Makes the authenticated user follow another user (may send a request if their tweets are protected).
  • TWITTER_UNFOLLOW_USER – Makes the authenticated user unfollow another user.
  • TWITTER_GET_BLOCKED_USERS – Retrieves the accounts blocked by a given user.
  • TWITTER_GET_MUTED_USERS – Retrieves accounts muted by the user.
  • TWITTER_MUTE_USER_BY_USER_ID – Mutes a target user for the authenticated user.
  • TWITTER_UNMUTE_USER_BY_USER_ID – Unmutes a previously muted user.
  • TWITTER_FOLLOWERS_BY_USER_ID – Lists followers of a specified user.
  • TWITTER_FOLLOWING_BY_USER_ID – Lists accounts a specified user follows.
  • TWITTER_USER_LOOKUP_BY_USERNAME – Fetches public profile info for a user by their username.
  • TWITTER_USER_LOOKUP_BY_ID – Fetches a user’s public profile by their ID.
  • TWITTER_USER_LOOKUP_BY_IDS – Fetches multiple users’ profiles by IDs.
  • TWITTER_USER_LOOKUP_BY_USERNAMES – Fetches multiple users’ profiles by usernames.
  • TWITTER_USER_LOOKUP_ME – Returns profile info for the authenticated user.
  • TWITTER_USER_HOME_TIMELINE_BY_USER_ID – Retrieves a user’s home timeline (their tweets/retweets).

​
Direct Messages (DMs)

  • TWITTER_CREATE_A_NEW_DM_CONVERSATION – Starts a new group DM with participants and an initial message.
  • TWITTER_SEND_A_NEW_MESSAGE_TO_A_DM_CONVERSATION – Sends a message (text/media) to an existing DM conversation.
  • TWITTER_SEND_A_NEW_MESSAGE_TO_A_USER – Sends a new DM to a user (creates a new conversation).
  • TWITTER_GET_DM_EVENTS_BY_ID – Fetches a single DM event by its event ID.
  • TWITTER_GET_DM_EVENTS_FOR_A_DM_CONVERSATION – Fetches DM events in a one-on-one conversation (newest first).
  • TWITTER_GET_RECENT_DM_EVENTS – Returns recent DM events for the authenticated user.
  • TWITTER_DELETE_DM – Deletes a DM event sent by the authenticated user (doesn’t delete the whole conversation).
  • TWITTER_RETRIEVE_DM_CONVERSATION_EVENTS – Fetches DM events for a conversation.

​
Spaces & Compliance

  • TWITTER_SEARCH_FOR_SPACES – Searches for live or scheduled spaces by query.
  • TWITTER_SPACE_LOOKUP_BY_SPACE_ID – Retrieves details for a space by its ID.
  • TWITTER_SPACE_LOOKUP_BY_THEIR_CREATORS – Retrieves spaces created by specified user IDs.
  • TWITTER_SPACE_LOOKUP_UP_SPACE_IDS – Fetches details for multiple spaces by ID.
  • TWITTER_FETCH_SPACE_TICKET_BUYERS_LIST – Lists users who bought tickets for a ticketed space.
  • TWITTER_CREATE_COMPLIANCE_JOB_REQUEST – Creates a compliance job (e.g. to check tweet/user IDs), returning an upload URL.
  • TWITTER_RETRIEVE_COMPLIANCE_JOBS – Lists your recent compliance jobs.
  • TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_ID – Retrieves details for a single compliance job.

​
Other Actions

  • TWITTER_HIDE_REPLIES – Hides or unhides a reply tweet.

​
Usage Notes

  • Handle tweet, user, and list IDs carefully to avoid errors.
  • Use search and streaming tools for advanced analytics and monitoring.
  • Combine tweet, list, and DM tools for powerful automation and engagement workflows.
Automate content posting, audience engagement, and analytics by combining multiple Twitter tools in your workflows.