Skip to main content
Twitter integration for posting tweets, managing lists, reading timelines, handling direct messages, searching the tweet archive, and interacting with users and spaces on the platform.

Setup

  1. In Agent Studio, go to ToolsTwitterConnect
  2. Sign in with your Twitter account and authorize access
  3. Review the requested permissions and click Allow

Available actions

ActionDescription
TWITTER_ADD_A_LIST_MEMBERAdds a user to a specified Twitter list owned by the authenticated user.
TWITTER_ADD_POST_TO_BOOKMARKSBookmarks an existing, accessible tweet for the authenticated user.
TWITTER_BOOKMARKS_BY_USERRetrieves all tweets bookmarked by the authenticated user.
TWITTER_CREATE_A_NEW_DM_CONVERSATIONCreates a new group direct message conversation with specified participants and an initial message.
TWITTER_CREATE_COMPLIANCE_JOB_REQUESTCreates a compliance job to check the status of tweet or user IDs in bulk.
TWITTER_CREATE_LISTCreates a new, empty Twitter list with a unique name for the authenticated user.
TWITTER_CREATION_OF_A_POSTCreates a tweet, optionally including text, media, polls, quotes, or replies.
TWITTER_DELETE_DMPermanently deletes a specific direct message event sent by the authenticated user.
TWITTER_DELETE_LISTPermanently deletes a Twitter list owned by the authenticated user.
TWITTER_FETCH_LIST_MEMBERS_BY_IDFetches the members of a specific Twitter list by its unique ID.
TWITTER_FETCH_SPACE_TICKET_BUYERS_LISTRetrieves users who purchased tickets for a specific ticketed Twitter Space.
TWITTER_FOLLOW_A_LISTSubscribes the authenticated user to a Twitter list’s timeline.
TWITTER_FOLLOWERS_BY_USER_IDRetrieves users who follow a specified public Twitter account.
TWITTER_FOLLOWING_BY_USER_IDRetrieves the list of users a specific Twitter account is following.
TWITTER_FOLLOW_USERFollows another Twitter user on behalf of the authenticated user.
TWITTER_FULL_ARCHIVE_SEARCHSearches the full archive of public tweets going back to March 2006.
TWITTER_FULL_ARCHIVE_SEARCH_COUNTSReturns aggregated tweet counts from the full archive matching a query, grouped by day, hour, or minute.
TWITTER_GET_A_USER_S_LIST_MEMBERSHIPSRetrieves all Twitter lists a specified user is a member of.
TWITTER_GET_A_USER_S_OWNED_LISTSRetrieves Twitter lists created and owned by a specific user.
TWITTER_GET_A_USER_S_PINNED_LISTSRetrieves the Twitter lists a specific user has pinned to their profile.
TWITTER_GET_BLOCKED_USERSReturns a read-only view of users blocked by the specified account.
TWITTER_GET_DM_EVENTS_BY_IDFetches a specific direct message event by its unique ID.
TWITTER_GET_DM_EVENTS_FOR_A_DM_CONVERSATIONFetches DM events for a one-on-one conversation with a specified participant.
TWITTER_GET_LIST_FOLLOWERSReturns users who follow a specific Twitter list.
TWITTER_GET_MUTED_USERSReturns users muted by the authenticated account.
TWITTER_GET_POST_RETWEETERS_ACTIONRetrieves users who publicly retweeted a specified tweet.
TWITTER_GET_RECENT_DM_EVENTSReturns recent direct message events for the authenticated user.
TWITTER_GET_USER_S_FOLLOWED_LISTSReturns metadata for lists a specific Twitter user follows.
TWITTER_HIDE_REPLIESHides or unhides a reply tweet from a conversation.
TWITTER_LIST_LOOKUP_BY_LIST_IDReturns metadata for a specific Twitter list by its ID.
TWITTER_LIST_POST_LIKERSRetrieves users who liked a specific tweet.
TWITTER_LIST_POSTS_TIMELINE_BY_LIST_IDFetches the most recent tweets posted by members of a specified Twitter list.
TWITTER_MUTE_USER_BY_USER_IDMutes a target user so their tweets no longer appear in the authenticated user’s timeline.
TWITTER_PIN_A_LISTPins a specified Twitter list to the authenticated user’s profile.
TWITTER_POST_DELETE_BY_POST_IDIrreversibly deletes a tweet authored by the authenticated user.
TWITTER_POST_LOOKUP_BY_POST_IDFetches full details for a single tweet by its unique ID.
TWITTER_POST_LOOKUP_BY_POST_IDSRetrieves detailed information for one or more tweets by their IDs.
TWITTER_POSTS_LABEL_STREAMEstablishes a real-time stream of events for when tweet content labels are applied or removed.
TWITTER_POST_USAGEFetches tweet usage statistics for a project to monitor API limits over a specified period.
TWITTER_RECENT_SEARCHSearches tweets from the last 7 days matching a query using Twitter’s search syntax.
TWITTER_RECENT_SEARCH_COUNTSReturns counts of tweets matching a query within the last 7 days, aggregated by minute, hour, or day.
TWITTER_REMOVE_A_BOOKMARKED_POSTRemoves a previously bookmarked tweet from the authenticated user’s bookmarks.
TWITTER_REMOVE_A_LIST_MEMBERRemoves a user from a Twitter list owned by the authenticated user.
TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_IDRetrieves the status and details of an existing compliance job by its ID.
TWITTER_RETRIEVE_COMPLIANCE_JOBSReturns a list of recent compliance jobs filtered by type and optionally by status.
TWITTER_RETRIEVE_DM_CONVERSATION_EVENTSRetrieves direct message events for a specific conversation ID.
TWITTER_RETRIEVE_POSTS_FROM_A_SPACERetrieves tweets shared in a specified Twitter Space.
TWITTER_RETRIEVE_POSTS_THAT_QUOTE_A_POSTRetrieves tweets that quote a specified tweet.
TWITTER_RETRIEVE_POSTS_THAT_REPOST_A_POSTRetrieves tweets that retweeted a specified tweet.
TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_IDRetrieves tweets liked by a specified Twitter user.
TWITTER_RETURNS_THE_OPEN_API_SPECIFICATION_DOCUMENTFetches the OpenAPI specification for Twitter’s API v2.
TWITTER_RETWEET_POSTRetweets a specified public tweet on behalf of the authenticated user.
TWITTER_SEARCH_FOR_SPACESSearches for Twitter Spaces by a text query, with optional filtering by state.
TWITTER_SEND_A_NEW_MESSAGE_TO_A_DM_CONVERSATIONSends a message with optional media attachments to an existing DM conversation.
TWITTER_SEND_A_NEW_MESSAGE_TO_A_USERSends a new direct message with optional media to a specified Twitter user.
TWITTER_SPACE_LOOKUP_BY_SPACE_IDRetrieves details for a Twitter Space by its unique ID.
TWITTER_SPACE_LOOKUP_BY_THEIR_CREATORSRetrieves Twitter Spaces created by a list of specified user IDs.
TWITTER_SPACE_LOOKUP_UP_SPACE_IDSFetches details for one or more Twitter Spaces by their IDs.
TWITTER_UNFOLLOW_A_LISTRemoves the authenticated user’s subscription to a Twitter list.
TWITTER_UNFOLLOW_USERUnfollows a specified Twitter user on behalf of the authenticated user.
TWITTER_UNLIKE_POSTRemoves the authenticated user’s like from a specified tweet.
TWITTER_UNMUTE_USER_BY_USER_IDUnmutes a previously muted user, restoring their tweets and notifications.
TWITTER_UNPIN_A_LISTUnpins a specified list from the authenticated user’s profile.
TWITTER_UNRETWEET_POSTRemoves the authenticated user’s retweet of a specified post.
TWITTER_UPDATE_LISTUpdates an existing Twitter list’s name, description, or privacy setting.
TWITTER_USER_HOME_TIMELINE_BY_USER_IDRetrieves a user’s home timeline showing tweets from accounts they follow in reverse chronological order.
TWITTER_USER_LIKE_POSTLikes a specified tweet on behalf of the authenticated user.
TWITTER_USER_LOOKUP_BY_IDRetrieves detailed public profile information for a Twitter user by their ID.
TWITTER_USER_LOOKUP_BY_IDSRetrieves profile information for multiple Twitter users by their IDs.
TWITTER_USER_LOOKUP_BY_USERNAMEFetches public profile information for a Twitter user by their username.
TWITTER_USER_LOOKUP_BY_USERNAMESRetrieves detailed information for 1 to 100 Twitter users by their usernames.
TWITTER_USER_LOOKUP_MEReturns profile information for the currently authenticated Twitter user.

Adding to an agent

  1. Open your agent in Agent Studio → Agent Builder
  2. Go to Tools and enable Twitter
  3. Select only the actions your agent needs
  4. Set auth mode: Shared (agent acts on one account) or Per-user (each end-user connects their own account)

Example use cases

Automated social media posting An agent monitors a content calendar or RSS feed and automatically posts tweets, including text, media, or polls, at scheduled times, keeping your audience engaged without manual effort. Brand mention and engagement tracking An agent uses recent search and full archive search to find tweets mentioning your brand or keywords, then surfaces engagement metrics and sentiment, enabling your team to respond quickly to trends or issues. Audience growth and list management An agent monitors follower activity, adds relevant users to curated Twitter lists, and follows or unfollows accounts based on defined criteria, helping you grow and maintain a targeted audience automatically.