Skip to main content
X (Twitter)
Previewv2.0.0
60 actions · 2 auth methods
MarketingMessaging

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.
2

Configure the Connector

Enable the connector and set up a Connector Profile in your project. See Setup Connector Profile.

Connector Profile · OAuth 2.0

Use for actions on behalf of a user (posting, liking, following). Requires user authorization.

Connector Profile · App-Only Bearer Token

Use for read-only access to public data (search, lookups). No user authorization needed.
3

Link an Account

Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:

Link Account · OAuth 2.0

Link Account · App-Only Bearer Token

4

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

Actions

|
|
60 actions
Action
Description
Required scopes
Create Post
Create a new post (tweet) on behalf of the authenticated user.
Delete Post
Delete a post (tweet) published by the authenticated user.
Get Post
Retrieve a single post (tweet) by its ID.
Search Recent Posts
Search for posts (tweets) from the past 7 days matching a query.
Get User Posts
Retrieve posts (tweets) published by a specific user.
Get User Mentions
Retrieve tweets mentioning a specific user.
Get Timeline
Retrieve the authenticated user’s reverse chronological home timeline of posts (tweets).
Repost Post
Repost (retweet) a post on behalf of the authenticated user.
Unrepost Post
Remove a repost (retweet) made by the authenticated user.
Get Reposted By
Retrieve users who reposted (retweeted) a specific post.
Get Quoted Posts
Retrieve posts that quote a specific post (quote tweets).
Hide Reply
Hide a reply to one of the authenticated user’s tweets.
Get Count Of Recent Posts
Get the count of posts (tweets) matching a search query over the past 7 days.
Get Authenticated User
Returns the authenticated user’s profile information.
Get User By ID
Retrieve a user’s profile by their unique ID.
Get User By Username
Retrieve a user’s profile by their @username.
Get User Followers
Retrieve a list of users who follow a specific user.
Get User Following
Retrieve a list of users that a specific user follows.
Follow User
Follow another user on behalf of the authenticated user.
Unfollow User
Unfollow a user on behalf of the authenticated user.
Get Muted Users
Retrieve users muted by the authenticated user.
Mute User
Mute a user on behalf of the authenticated user.
Unmute User
Remove a mute on behalf of the authenticated user.
Get Blocked Users
Retrieve users blocked by the authenticated user.
Block User
Block a user on behalf of the authenticated user.
Unblock User
Remove a block on behalf of the authenticated user.
Get DM Events
Retrieve direct message events for the authenticated user.
Get DM Conversation Events
Retrieve events from a specific direct message conversation.
Create DM Message By Conversation ID
Send a direct message (DM) to an existing conversation by conversation ID.
Create DM Conversation And Send Message
Create a new group DM conversation and send an initial message.
Create DM Message By Participant ID
Send a direct message (DM) to a specific user, creating a new 1-on-1 conversation if one does not exist.
Get List
Retrieve a single X list by its ID.
Get User Owned Lists
Retrieve lists owned by a specific user.
Create List
Create a new X list on behalf of the authenticated user.
Update List
Update a list’s name, description, or privacy setting.
Delete List
Delete a list owned by the authenticated user.
Get List Posts
Retrieve posts (tweets) from members of a specific list.
Get List Members
Retrieve users who are members of a specific list.
Add List Member
Add a user to a list owned by the authenticated user.
Remove List Member
Remove a user from a list owned by the authenticated user.
Get User List Memberships
Retrieve lists that a user is a member of.
Pin List
Pin a list to the authenticated user’s account.
Unpin List
Unpin a list from the authenticated user’s account.
Get Pinned Lists
Retrieve lists pinned by the authenticated user.
Get Space
Retrieve a single X Space by its ID.
Search Spaces
Search for X Spaces by keyword.
Get Spaces By Creator
Retrieve live or scheduled Spaces created by specific users.
Get Liked Posts
Retrieve posts (tweets) liked by a specific user.
Get Liking Users
Retrieve users who liked a specific tweet.
Like Post
Like a post (tweet) on behalf of the authenticated user.
Unlike Post
Remove a like from a post (tweet) on behalf of the authenticated user.
Get Bookmarks
Retrieve bookmarked tweets for the authenticated user.
Create Bookmark
Bookmark a post (tweet) for the authenticated user.
Delete Bookmark
Remove a post (tweet) from the authenticated user’s bookmarks.
Get Trends By Location
Retrieve trending topics for a specific location by WOEID.
Upload Media
Upload an image, GIF, or subtitle file in a single request and get a media ID to attach to posts or DMs.
Initialize Media Upload
Start a chunked media upload session for videos or large files.
Append Media Upload
Upload one chunk of media to an initialized chunked upload session.
Finalize Media Upload
Complete a chunked media upload after all chunks are appended.
Get Media Upload Status
Check the processing status of an uploaded video or GIF.