> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# X (Twitter)

> How to set up the X (Twitter) connector, plus the actions that are available.

![X (Twitter)](https://stackone-logos.com/api/x/filled/svg)

v3.0.1[See changelog](https://docs.stackone.com/connectors/x/changelog.md)

[60 actions](#actions) · 2 auth methods

Marketing
Messaging

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/x/guides/connector-profile/oauth-2-0.md)
>
> Delegated access on behalf of a signed-in X user, for posting, liking, following and direct messages. Requires an X app...

> [card] [App-Only Bearer Token · Connector Profile](https://docs.stackone.com/connectors/x/guides/connector-profile/app-only-bearer-token.md)
>
> Use for read-only access to public data (search, lookups). No user authorization needed.

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/x/guides/link-account/oauth-2-0.md)

> [card] [App-Only Bearer Token · Link Account](https://docs.stackone.com/connectors/x/guides/link-account/app-only-bearer-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

App-Only Bearer Token

OAuth 2.0

No auth methods found

Scopes

Select all
|
Clear

block.read

block.write

bookmark.read

bookmark.write

dm.read

dm.write

follows.read

follows.write

like.read

like.write

list.read

list.write

media.write

mute.read

mute.write

space.read

tweet.moderate.write

tweet.read

tweet.write

users.read

No scopes found

60 actions

ActionDescriptionRequired scopes

Create Post`x_create_post`

Create a new post (tweet) on behalf of the authenticated user.

`tweet.read``tweet.write``users.read`

Delete Post`x_delete_post`

Delete a post (tweet) published by the authenticated user.

`tweet.read``tweet.write``users.read`

Get Post`x_get_post`

Retrieve a single post (tweet) by its ID.

`tweet.read``users.read`

Search Recent Posts`x_search_recent_posts`

Search for posts (tweets) from the past 7 days matching a query.

`tweet.read``users.read`

Get User Posts`x_get_user_posts`

Retrieve posts (tweets) published by a specific user.

`tweet.read``users.read`

Get User Mentions`x_get_user_mentions`

Retrieve tweets mentioning a specific user.

`tweet.read``users.read`

Get Timeline`x_get_timeline`

Retrieve the authenticated user's reverse chronological home timeline of posts (tweets).

`tweet.read``users.read`

Repost Post`x_repost_post`

Repost (retweet) a post on behalf of the authenticated user.

`tweet.read``tweet.write``users.read`

Unrepost Post`x_unrepost_post`

Remove a repost (retweet) made by the authenticated user.

`tweet.read``tweet.write``users.read`

Get Reposted By`x_get_reposted_by`

Retrieve users who reposted (retweeted) a specific post.

`tweet.read``users.read`

Get Quoted Posts`x_get_quoted_posts`

Retrieve posts that quote a specific post (quote tweets).

`tweet.read``users.read`

Hide Reply`x_hide_reply`

Hide a reply to one of the authenticated user's tweets.

`tweet.read``tweet.moderate.write``users.read`

Get Count Of Recent Posts`x_get_recent_post_counts`

Get the count of posts (tweets) matching a search query over the past 7 days.

Get Authenticated User`x_get_me`

Returns the authenticated user's profile information.

`tweet.read``users.read`

Get User By ID`x_get_user_by_id`

Retrieve a user's profile by their unique ID.

`tweet.read``users.read`

Get User By Username`x_get_user_by_username`

Retrieve a user's profile by their @username.

`tweet.read``users.read`

Get User Followers`x_get_user_followers`

Retrieve a list of users who follow a specific user.

`tweet.read``users.read``follows.read`

Get User Following`x_get_user_following`

Retrieve a list of users that a specific user follows.

`tweet.read``users.read``follows.read`

Follow User`x_follow_user`

Follow another user on behalf of the authenticated user.

`tweet.read``users.read``follows.write`

Unfollow User`x_unfollow_user`

Unfollow a user on behalf of the authenticated user.

`tweet.read``users.read``follows.write`

Get Muted Users`x_get_muted_users`

Retrieve users muted by the authenticated user.

`tweet.read``users.read``mute.read`

Mute User`x_mute_user`

Mute a user on behalf of the authenticated user.

`tweet.read``users.read``mute.write`

Unmute User`x_unmute_user`

Remove a mute on behalf of the authenticated user.

`tweet.read``users.read``mute.write`

Get Blocked Users`x_get_blocked_users`

Retrieve users blocked by the authenticated user.

`tweet.read``users.read``block.read`

Block User`x_block_user`

Block a user on behalf of the authenticated user.

`tweet.read``users.read``block.write`

Unblock User`x_unblock_user`

Remove a block on behalf of the authenticated user.

`tweet.read``users.read``block.write`

Get DM Events`x_get_dm_events`

Retrieve direct message events for the authenticated user.

`tweet.read``users.read``dm.read`

Get DM Conversation Events`x_get_dm_conversation_events`

Retrieve events from a specific direct message conversation.

`tweet.read``users.read``dm.read`

Create DM Message By Conversation ID`x_create_dm_message_by_conversation_id`

Send a direct message (DM) to an existing conversation by conversation ID.

`tweet.read``users.read``dm.write`

Create DM Conversation And Send Message`x_create_dm_conversation`

Create a new group DM conversation and send an initial message.

`tweet.read``users.read``dm.write`

Create DM Message By Participant ID`x_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.

`tweet.read``users.read``dm.write`

Get List`x_get_list`

Retrieve a single X list by its ID.

`tweet.read``users.read``list.read`

Get User Owned Lists`x_get_user_owned_lists`

Retrieve lists owned by a specific user.

`tweet.read``users.read``list.read`

Create List`x_create_list`

Create a new X list on behalf of the authenticated user.

`tweet.read``users.read``list.read``list.write`

Update List`x_update_list`

Update a list's name, description, or privacy setting.

`tweet.read``users.read``list.write`

Delete List`x_delete_list`

Delete a list owned by the authenticated user.

`tweet.read``users.read``list.write`

Get List Posts`x_get_list_posts`

Retrieve posts (tweets) from members of a specific list.

`tweet.read``users.read``list.read`

Get List Members`x_get_list_members`

Retrieve users who are members of a specific list.

`tweet.read``users.read``list.read`

Add List Member`x_add_list_member`

Add a user to a list owned by the authenticated user.

`tweet.read``users.read``list.write`

Remove List Member`x_remove_list_member`

Remove a user from a list owned by the authenticated user.

`tweet.read``users.read``list.write`

Get User List Memberships`x_get_user_list_memberships`

Retrieve lists that a user is a member of.

`tweet.read``users.read``list.read`

Pin List`x_pin_list`

Pin a list to the authenticated user's account.

`tweet.read``users.read``list.write`

Unpin List`x_unpin_list`

Unpin a list from the authenticated user's account.

`tweet.read``users.read``list.write`

Get Pinned Lists`x_get_pinned_lists`

Retrieve lists pinned by the authenticated user.

`tweet.read``users.read``list.read`

Get Space`x_get_space`

Retrieve a single X Space by its ID.

`tweet.read``users.read``space.read`

Search Spaces`x_search_spaces`

Search for X Spaces by keyword.

`tweet.read``users.read``space.read`

Get Spaces By Creator`x_get_spaces_by_creator`

Retrieve live or scheduled Spaces created by specific users.

`tweet.read``users.read``space.read`

Get Liked Posts`x_get_liked_posts`

Retrieve posts (tweets) liked by a specific user.

`tweet.read``users.read``like.read`

Get Liking Users`x_get_liking_users`

Retrieve users who liked a specific tweet.

`tweet.read``users.read``like.read`

Like Post`x_like_post`

Like a post (tweet) on behalf of the authenticated user.

`tweet.read``users.read``like.write`

Unlike Post`x_unlike_post`

Remove a like from a post (tweet) on behalf of the authenticated user.

`tweet.read``users.read``like.write`

Get Bookmarks`x_get_bookmarks`

Retrieve bookmarked tweets for the authenticated user.

`tweet.read``users.read``bookmark.read`

Create Bookmark`x_create_bookmark`

Bookmark a post (tweet) for the authenticated user.

`tweet.read``users.read``bookmark.write`

Delete Bookmark`x_delete_bookmark`

Remove a post (tweet) from the authenticated user's bookmarks.

`tweet.read``users.read``bookmark.write`

Get Trends By Location`x_get_trends_by_woeid`

Retrieve trending topics for a specific location by WOEID.

Upload Media`x_upload_media`

Upload an image, GIF, or subtitle file in a single request and get a media ID to attach to posts or DMs.

`media.write`

Initialize Media Upload`x_initialize_media_upload`

Start a chunked media upload session for videos or large files.

`media.write`

Append Media Upload`x_append_media_upload`

Upload one chunk of media to an initialized chunked upload session.

`media.write`

Finalize Media Upload`x_finalize_media_upload`

Complete a chunked media upload after all chunks are appended.

`media.write`

Get Media Upload Status`x_get_media_upload_status`

Check the processing status of an uploaded video or GIF.

`media.write`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.