Connect X to Agaro ERP
Connect X to Agaro so your team and the AGARO Assistant can post, search, and manage your X account activity, with the same permissions and audit trail as everything else in your workspace.
Supported tools
Every X action Agaro can use out of the box.
Add a list member
Adds a user to a specified X List; the list must be owned by the authenticated user.
Add post to bookmarks
Adds a specified, existing, and accessible Tweet to a user's bookmarks, with success indicated by the 'bookmarked' field in the response.
Append Media Upload
Append data chunk to an ongoing media upload session on X/X. Use this action during chunked media uploads to append each segment of media data in sequence.
Get bookmarks by user
Retrieves Tweets bookmarked by the authenticated user, where the provided User ID must match the authenticated user's ID.
Create activity subscription
Tool to create a subscription for an X activity event. Use when you need to monitor specific user activities like profile updates, follows, or spaces events.
Create compliance job
Creates 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.
Create group DM conversation
Creates a new group Direct Message (DM) conversation on X.
Create a list
Creates a new, empty List on X (formerly X), for which the provided name must be unique for the authenticated user; accounts are added separately.
Create a post
Creates a Tweet on X; text is required unless card_uri, media_media_ids, poll_options, or quote_tweet_id is provided.
Delete direct message
Permanently deletes a specific X Direct Message (DM) event using its event_id if the authenticated user sent it; this action is irreversible and does not delete entire conversations.
Delete list
Permanently deletes a specified X List using its ID, which must be owned by the authenticated user; this action is irreversible and the list must already exist.
Get followers by user id
Retrieves a list of users who follow a specified public X user ID.
Get following by user ID
Retrieves users followed by a specific X user, allowing pagination and customization of returned user and tweet data fields via expansions.
Follow a list
Allows the authenticated user (id) to follow a specific X List (list_id) they are permitted to access, subscribing them to the list's timeline; this does not automatically follow individual list members.
Follow a user
Allows 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.
Search full archive of tweets
Searches the full archive of public Tweets from March 2006 onwards; use 'start_time' and 'end_time' together for a defined time window.
Get users blocked by user ID
Retrieves the authenticated user's own block list. IMPORTANT: You can only retrieve YOUR OWN block list - the id parameter must be the authenticated user's ID.
Retrieve compliance job by id
Retrieves status, download/upload URLs, and other details for an existing X compliance job specified by its unique ID.
Retrieve compliance jobs
Returns a list of recent compliance jobs, filtered by type (tweets or users) and optionally by status.
Get DM events for a DM conversation
Fetches 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.
Get DM events by ID
Fetches 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 the authenticated user.
Lookup list by ID
Returns metadata for a specific X List, identified by its ID; does not return list members but can expand the owner's User object via the expansions parameter.
Get list followers
Fetches a list of users who follow a specific X List, identified by its ID; ensure the authenticated user has access if the list is private.
Fetch list members by id
Fetches members of a specific X List, identified by its unique ID.
Get Media Upload Status
Get the processing status of uploaded media (videos/GIFs) on X/X. Only call this when the FINALIZE command returned a processing_info field.
Get muted users
Returns user objects muted by the X user identified by the id path parameter.
Fetch OpenAPI specification
Fetches the OpenAPI specification (JSON) for X's API v2, used to programmatically understand the API's structure for developing client libraries or tools.
Get Post analytics
Tool to retrieve analytics data for specified Posts within a defined time range. Use when you need engagement metrics, impressions, or other analytics for one or more Posts.
Get post retweeters
Retrieves users who publicly retweeted a specified public Post ID, excluding Quote Tweets and retweets from private accounts.
Retrieve retweets of a post
Retrieves Tweets that Retweeted a specified public or authenticated-user-accessible Tweet ID, optionally customizing the response with fields and expansions.
Fetch tweet usage data
Fetches 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.
Get recent direct message events
Returns recent Direct Message events for the authenticated user, such as new messages or changes in conversation participants.
Look up space by ID
Retrieves details for a X Space by its ID, allowing for customization and expansion of related data, provided the Space ID is valid and accessible.
Retrieve posts from a space
Retrieves Tweets that were shared/posted during a X Space broadcast.
Get spaces by creator IDs
Retrieves X Spaces created by a list of specified User IDs, with options to customize returned data fields.
Get space information by IDs
Fetches detailed information for one or more X Spaces (live, scheduled, or ended) by their unique IDs; at least one Space ID must be provided.
Fetch space ticket buyers list
Retrieves a list of users who purchased tickets for a specific, valid, and ticketed X Space.
Look up user by ID
Retrieves detailed public information for a X user by their ID, optionally expanding related data (e.g., pinned tweets) and specifying particular user or tweet fields to return.
Get user's followed lists
Returns metadata (not Tweets) for lists a specific X user follows, optionally including expanded owner details.
Get a user's list memberships
Retrieves all X Lists a specified user is a member of, including public Lists and private Lists the authenticated user is authorized to view.
Get a user's owned lists
Call this action to retrieve Lists created (owned) by a specific X user, not Lists they follow or are subscribed to.
Get a user's pinned lists
Retrieves the Lists a specific, existing X user has pinned to their profile to highlight them.
Look up users by IDs
Retrieves detailed information for specified X (formerly X) user IDs, optionally customizing returned fields and expanding related entities.
Set reply visibility
Hides or unhides an existing reply Tweet. This action allows the authenticated user to hide or unhide a reply to a conversation they own (started).
Initialize Media Upload
Initialize a media upload session for X/X. Use this to start a chunked media upload process, which returns a media_id for subsequent APPEND and FINALIZE commands.
List post likers
Retrieves users who have liked the Post (Tweet) identified by the provided ID.
List posts timeline by list ID
Fetches the most recent Tweets posted by members of a specified X List.
Mute user by ID
Mutes 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.
Pin a list
Pins 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.
Delete tweet
Irreversibly deletes a specific Tweet by its ID; the Tweet may persist in third-party caches after deletion.
Look up post by id
Fetches comprehensive details for a single Tweet by its unique ID, provided the Tweet exists and is accessible.
Get tweets by IDs
Retrieves detailed information for one or more Posts (Tweets) identified by their unique IDs, allowing selection of specific fields and expansions.
Search recent tweets
Searches 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) DEFAULT FIELDS: Tweet…
Remove a list member
Removes a user from a X 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.
Remove a bookmarked post
Removes 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.
Retrieve DM conversation events
Retrieves Direct Message (DM) events for a specific conversation ID on X, useful for analyzing messages and participant activities.
Retrieve posts that quote a post
Retrieves Tweets that quote a specified Tweet, requiring a valid Tweet ID.
Retrieve liked tweets by user ID
Retrieves Tweets liked by a specified X user, provided their liked tweets are public or accessible.
Retweet post
Retweets a Tweet for the authenticated user. The user ID is automatically fetched from the authenticated session - you only need to provide the tweet_id to retweet.
Get full archive search counts
Returns 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 since_id/until_id cannot be used with…
Fetch recent tweet counts
Retrieves the count of Tweets matching a specified search query within the last 7 days, aggregated by 'minute', 'hour', or 'day'.
Search for spaces
Searches for X Spaces by a textual query, optionally filtering by state (live, scheduled, all) to discover audio conversations.
Send a new message to a user
Sends a new Direct Message with text and/or media (media_id for attachments must be pre-uploaded) to a specified X user; this creates a new DM and does not modify existing messages.
Send a new message to a DM conversation
Sends a message, with optional text and/or media attachments (using pre-uploaded media_ids), to a specified X Direct Message conversation.
Get tweets label stream
Stream real-time Tweet label events (apply/remove). Requires Enterprise access and App-Only OAuth 2.0 auth.
Unfollow a list
Enables a user (via id) to unfollow a specific X List (via list_id), which removes its tweets from their timeline and stops related notifications; the action reports following: false on success, even if the user…
Unfollow user
Allows the authenticated user to unfollow an existing X user (target_user_id), which removes the follow relationship.
Unlike post
Allows 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.
Unmute a user by user ID
Unmutes a target user for the authenticated user, allowing them to see Tweets and notifications from the target user again.
Unpin a list
Unpins a List (specified by list_id) from the authenticated user's profile. The user ID is automatically retrieved if not provided.
Unretweet post
Removes a user's retweet of a specified Post, if the user had previously retweeted it.
Update list attributes
Updates an existing X List's name, description, or privacy status, requiring the List ID and at least one mutable property.
Upload Media
Upload media (images only) to X/X using the v2 API. Supports tweet_image, dm_image, and subtitles media categories only.
Get user reverse chronological timeline
Retrieves the home timeline (reverse chronological feed) for the authenticated X user.
Like a tweet
Allows 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.
Look up user by username
Fetches public profile information for a valid and existing X user by their username, optionally expanding related data like pinned Tweets; results may be limited for protected profiles not followed by the…
Look up users by username
Retrieves detailed information for 1 to 100 X users by their usernames (each 1-15 alphanumeric characters/underscores), allowing customizable user/tweet fields and expansion of related data like pinned tweets.
Get authenticated user
Returns profile information for the currently authenticated X user, customizable via request fields.
Nothing matches that search.
Put X to work inside Agaro.
Tell us how your team uses X today and we will show you how it connects.