Twitter
for LuumenAI
Twitter, Inc. was an American social media company based in San Francisco, California, which operated and was named for named for its flagship social media network prior to its rebrand as X.
Bring Twitter into the same conversation as the systems behind it. LuumenAI reads campaigns, audiences, and delivery status for context, and changes them only through previewed, approved, audited actions.
The Twitter toolbox
79 tools: 47 read, 32 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadGet bookmarks by userRetrieves Tweets bookmarked by the authenticated user, where the provided User ID must match the authenticated user's ID.
- ReadGet followers by user idRetrieves a list of users who follow a specified public Twitter user ID.
- ReadGet following by user IDRetrieves users followed by a specific Twitter user, allowing pagination and customization of returned user and tweet data fields via expansions.
- ReadSearch full archive of tweetsSearches the full archive of public Tweets from March 2006 onwards; use 'start_time' and 'end_time' together for a defined time window.
- ReadGet users blocked by user IDRetrieves the authenticated user's own block list.
- ReadRetrieve compliance job by idRetrieves status, download/upload URLs, and other details for an existing Twitter compliance job specified by its unique ID.
- ReadRetrieve compliance jobsReturns a list of recent compliance jobs, filtered by type (tweets or users) and optionally by status.
- ReadGet DM events for a DM conversationFetches Direct Message (DM) events for a one-on-one conversation with a specified participant ID, ordered chronologically newest to oldest; does not support group DMs.
- ReadGet DM events by IDFetches a specific Direct Message (DM) event by its unique ID, allowing optional expansion of related data like users or tweets; ensure the `event_id` refers to an existing DM event accessible to…
- ReadLookup list by IDReturns metadata for a specific Twitter List, identified by its ID; does not return list members but can expand the owner's User object via the `expansions` parameter.
- ReadGet list followersFetches a list of users who follow a specific Twitter List, identified by its ID; ensure the authenticated user has access if the list is private.
- ReadFetch list members by idFetches members of a specific Twitter List, identified by its unique ID.
- ReadGet Media Upload StatusGet the processing status of uploaded media (videos/GIFs) on X/Twitter.
- ReadGet muted usersReturns user objects muted by the X user identified by the `id` path parameter.
- ReadFetch OpenAPI specificationFetches the OpenAPI specification (JSON) for Twitter's API v2, used to programmatically understand the API's structure for developing client libraries or tools.
- ReadGet Post analyticsRetrieve analytics data for specified Posts within a defined time range.
- ReadGet post retweetersRetrieves users who publicly retweeted a specified public Post ID, excluding Quote Tweets and retweets from private accounts.
- ReadRetrieve retweets of a postRetrieves Tweets that Retweeted a specified public or authenticated-user-accessible Tweet ID, optionally customizing the response with fields and expansions.
- ReadFetch tweet usage dataFetches Tweet usage statistics for a Project (e.g., consumption, caps, daily breakdowns for Project & Client Apps) to monitor API limits; data can be retrieved for 1 to 90 days.
- ReadGet recent direct message eventsReturns recent Direct Message events for the authenticated user, such as new messages or changes in conversation participants.
- ReadLook up space by IDRetrieves details for a Twitter Space by its ID, allowing for customization and expansion of related data, provided the Space ID is valid and accessible.
- ReadRetrieve posts from a spaceRetrieves Tweets that were shared/posted during a Twitter Space broadcast.
- ReadGet spaces by creator IDsRetrieves Twitter Spaces created by a list of specified User IDs, with options to customize returned data fields.
- ReadGet space information by IDsFetches detailed information for one or more Twitter Spaces (live, scheduled, or ended) by their unique IDs; at least one Space ID must be provided.
- ReadFetch space ticket buyers listRetrieves a list of users who purchased tickets for a specific, valid, and ticketed Twitter Space.
- ReadLook up user by IDRetrieves detailed public information for a Twitter user by their ID, optionally expanding related data (e.g., pinned tweets) and specifying particular user or tweet fields to return.
- ReadGet user's followed listsReturns metadata (not Tweets) for lists a specific Twitter user follows, optionally including expanded owner details.
- ReadGet a user's list membershipsRetrieves all Twitter Lists a specified user is a member of, including public Lists and private Lists the authenticated user is authorized to view.
- ReadGet a user's owned listsCall this action to retrieve Lists created (owned) by a specific Twitter user, not Lists they follow or are subscribed to.
- ReadGet a user's pinned listsRetrieves the Lists a specific, existing Twitter user has pinned to their profile to highlight them.
- ReadLook up users by IDsRetrieves detailed information for specified X (formerly Twitter) user IDs, optionally customizing returned fields and expanding related entities.
- ReadList post likersRetrieves users who have liked the Post (Tweet) identified by the provided ID.
- ReadList posts timeline by list IDFetches the most recent Tweets posted by members of a specified Twitter List.
- ReadLook up post by idFetches comprehensive details for a single Tweet by its unique ID, provided the Tweet exists and is accessible.
- ReadGet tweets by IDsRetrieves detailed information for one or more Posts (Tweets) identified by their unique IDs, allowing selection of specific fields and expansions.
- ReadSearch recent tweetsSearches Tweets from the last 7 days matching a query (using X's search syntax), ideal for real-time analysis, trend monitoring, or retrieving posts from specific users (e.g., `from:username`)…
- ReadRetrieve DM conversation eventsRetrieves Direct Message (DM) events for a specific conversation ID on Twitter, useful for analyzing messages and participant activities.
- ReadRetrieve posts that quote a postRetrieves Tweets that quote a specified Tweet, requiring a valid Tweet ID.
- ReadRetrieve liked tweets by user IDRetrieves Tweets liked by a specified Twitter user, provided their liked tweets are public or accessible.
- ReadGet full archive search countsReturns a count of Tweets from the full archive that match a specified query, aggregated by day, hour, or minute; `start_time` must be before `end_time` if both are provided, and…
- ReadFetch recent tweet countsRetrieves the count of Tweets matching a specified search query within the last 7 days, aggregated by 'minute', 'hour', or 'day'.
- ReadSearch for spacesSearches for Twitter Spaces by a textual query, optionally filtering by state (live, scheduled, all) to discover audio conversations.
- ReadGet tweets label streamStream real-time Tweet label events (apply/remove).
- ReadGet user reverse chronological timelineRetrieves the home timeline (reverse chronological feed) for the authenticated Twitter user.
- ReadLook up user by usernameFetches public profile information for a valid and existing Twitter user by their username, optionally expanding related data like pinned Tweets; results may be limited for protected profiles not…
- ReadLook up users by usernameRetrieves detailed information for 1 to 100 Twitter users by their usernames (each 1-15 alphanumeric characters/underscores), allowing customizable user/tweet fields and expansion of related data…
- ReadGet authenticated userReturns profile information for the currently authenticated X user, customizable via request fields.
- WriteAdd a list memberAdds a user to a specified Twitter List; the list must be owned by the authenticated user. Approval by default
- WriteAdd post to bookmarksAdds a specified, existing, and accessible Tweet to a user's bookmarks, with success indicated by the 'bookmarked' field in the response. Approval by default
- WriteAppend Media UploadAppend data chunk to an ongoing media upload session on X/Twitter. Approval by default
- WriteCreate activity subscriptionCreate a subscription for an X activity event. Approval by default
- WriteCreate compliance jobCreates a new compliance job to check the status of Tweet or user IDs; upload IDs as a plain text file (one ID per line) to the `upload_url` received in the response. Approval by default
- WriteCreate group DM conversationCreates a new group Direct Message (DM) conversation on Twitter. Approval by default
- WriteCreate a listCreates a new, empty List on X (formerly Twitter), for which the provided name must be unique for the authenticated user; accounts are added separately. Approval by default
- WriteCreate a postCreates a Tweet on Twitter; `text` is required unless `card_uri`, `media_media_ids`, `poll_options`, or `quote_tweet_id` is provided. Approval by default
- WriteDelete direct messagePermanently deletes a specific Twitter Direct Message (DM) event using its `event_id` if the authenticated user sent it; this action is irreversible and does not delete entire conversations. Approval by default
- WriteDelete listPermanently deletes a specified Twitter List using its ID, which must be owned by the authenticated user; this action is irreversible and the list must already exist. Approval by default
- WriteFollow a listAllows the authenticated user (`id`) to follow a specific Twitter List (`list_id`) they are permitted to access, subscribing them to the list's timeline; this does not automatically follow… Approval by default
- WriteFollow a userAllows an authenticated user (path `id`) to follow another user (`target_user_id`), which results in a pending request if the target user's tweets are protected. Approval by default
- WriteSet reply visibilityHides or unhides an existing reply Tweet. Approval by default
- WriteInitialize Media UploadInitialize a media upload session for X/Twitter. Approval by default
- WriteMute user by IDMutes a target user on behalf of an authenticated user, preventing the target's Tweets and Retweets from appearing in the authenticated user's home timeline without notifying the target. Approval by default
- WritePin a listPins a specified List to the authenticated user's profile, provided the List exists, the user has access rights, and the pin limit (typically 5 Lists) is not exceeded. Approval by default
- WriteDelete tweetIrreversibly deletes a specific Tweet by its ID; the Tweet may persist in third-party caches after deletion. Approval by default
- WriteRemove a list memberRemoves a user from a Twitter List; the response `is_member` field will be `false` if removal was successful or the user was not a member, and the updated list of members is not returned. Approval by default
- WriteRemove a bookmarked postRemoves a Tweet, specified by `tweet_id`, from the authenticated user's bookmarks; the Tweet must have been previously bookmarked by the user for the action to have an effect. Approval by default
- WriteRetweet postRetweets a Tweet for the authenticated user. Approval by default
- WriteSend a new message to a userSends a new Direct Message with text and/or media (media_id for attachments must be pre-uploaded) to a specified Twitter user; this creates a new DM and does not modify existing messages. Approval by default
- WriteSend a new message to a DM conversationSends a message, with optional text and/or media attachments (using pre-uploaded `media_id`s), to a specified Twitter Direct Message conversation. Approval by default
- WriteUnfollow a listEnables a user (via `id`) to unfollow a specific Twitter List (via `list_id`), which removes its tweets from their timeline and stops related notifications; the action reports `following: false` on… Approval by default
- WriteUnfollow userAllows the authenticated user to unfollow an existing Twitter user (`target_user_id`), which removes the follow relationship. Approval by default
- WriteUnlike postAllows an authenticated user (`id`) to remove their like from a specific post (`tweet_id`); the action is idempotent and completes successfully even if the post was not liked. Approval by default
- WriteUnmute a user by user IDUnmutes a target user for the authenticated user, allowing them to see Tweets and notifications from the target user again. Approval by default
- WriteUnpin a listUnpins a List (specified by list_id) from the authenticated user's profile. Approval by default
- WriteUnretweet postRemoves a user's retweet of a specified Post, if the user had previously retweeted it. Approval by default
- WriteUpdate list attributesUpdates an existing Twitter List's name, description, or privacy status, requiring the List ID and at least one mutable property. Approval by default
- WriteUpload Large MediaUse this to upload a single media file to X/Twitter. Approval by default
- WriteUpload MediaUpload media (images only) to X/Twitter using the v2 API. Approval by default
- WriteLike a tweetAllows the authenticated user to like a specific, accessible Tweet, provided neither user has blocked the other and the authenticated user is not restricted from liking. Approval by default
Questions
How does LuumenAI connect to Twitter?
Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Twitter on its own?
Read actions answer immediately. Anything that writes — add a list member, add post to bookmarks, append media upload, create activity subscription, and more — is shown as a plan and requires approval by default, including the 11 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Twitter — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
ActiveCampaignActiveCampaign is a marketing automation and CRM platform enabling businesses to manage email campaigns, sales pipelines, and customer segmentation to boost engagement and drive growth
ActiveTrailActiveTrail is the world's friendliest email marketing platform, newsletter software and marketing automation software.
AdtractionAdtraction is an affiliate marketing platform for managing partner programs, tracking links, transactions, commissions, statistics, and payments.
AdyntelAdyntel provides an API to retrieve LinkedIn ads for a given company using the company's domain or LinkedIn Page ID.Put Twitter to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.