# Twitter

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.

- **Category:** social media accounts
- **Auth:** OAUTH2
- **Tools:** 75
- **Triggers:** 0
- **Slug:** `TWITTER`
- **Version:** 20260217_00

## Frequently Asked Questions

### Why are Devcaster managed credentials no longer available for Twitter?

As of February 2026, Devcaster managed credentials for the Twitter toolkit have been removed. You must now bring your own Twitter API credentials. To migrate:

1. Create a Twitter Developer account and obtain API credentials from the [Twitter Developer Portal](https://developer.x.com/en/portal/dashboard).
2. Set up a custom auth configuration with your credentials in Devcaster.

If you were relying on managed credentials, your Twitter integrations will stop working until you configure your own. See the [changelog entry](/docs/changelog/2026/02/12) for full details.

### Why am I getting rate limit or "UsageCapExceeded" errors on Twitter?

Twitter enforces strict rate limits per app. Use your own OAuth app with appropriate rate limit allocations for production workloads.

### Why can't I access certain Twitter API endpoints?

Twitter enforces plan-based access tiers. Check your project's product and plan for the required permissions at the [Twitter Developer Portal](https://developer.x.com/en/portal/products).

### Why am I getting 403 errors on Twitter API calls?

Your developer account or project may not have the required access level for the endpoint. Check your enrollment and access tier in the Twitter Developer Portal.

---

## Tools

### Add a list member

**Slug:** `TWITTER_ADD_A_LIST_MEMBER`

Adds a user to a specified Twitter List; the list must be owned by the authenticated user.

### Add post to bookmarks

**Slug:** `TWITTER_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.

### Get bookmarks by user

**Slug:** `TWITTER_BOOKMARKS_BY_USER`

Retrieves Tweets bookmarked by the authenticated user, where the provided User ID must match the authenticated user's ID.

### Create group DM conversation

**Slug:** `TWITTER_CREATE_A_NEW_DM_CONVERSATION`

Creates a new group Direct Message (DM) conversation on Twitter. REQUIRED PARAMETERS: - conversation_type: Must be 'Group' - participant_ids: List of Twitter user IDs to include in the conversation - message: JSON object with the initial message. Must contain 'text' field. To include media attachments, use message.attachments array with media_id (NOT media_url): {"text": "...", "attachments": [{"media_id": "1234567890"}]} Note: Media must be uploaded first using the upload_media action to obtain a media_id.

### Create compliance job

**Slug:** `TWITTER_CREATE_COMPLIANCE_JOB_REQUEST`

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 a list

**Slug:** `TWITTER_CREATE_LIST`

Creates a new, empty List on X (formerly Twitter), for which the provided name must be unique for the authenticated user; accounts are added separately.

### Create a post

**Slug:** `TWITTER_CREATION_OF_A_POST`

Creates a Tweet on Twitter; `text` is required unless `card_uri`, `media_media_ids`, `poll_options`, or `quote_tweet_id` is provided. Example - Creating a tweet with media and location: { "text": "Check out our latest product update! 🚀", "media_media_ids": ["1455952740635586573"], "geo_place_id": "df51dec6f4ee2b2c" } Example - Quote tweet with commentary: { "text": "This is a game-changer for the industry! Here's why... 🧵", "quote_tweet_id": "1453828617121234945" } Example - Reply to a tweet: { "text": "Great point! Here's my take on this...", "reply_in_reply_to_tweet_id": "1453828617121234945" }

### Delete direct message

**Slug:** `TWITTER_DELETE_DM`

Permanently 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.

### Delete list

**Slug:** `TWITTER_DELETE_LIST`

Permanently 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.

### Fetch list members by id

**Slug:** `TWITTER_FETCH_LIST_MEMBERS_BY_ID`

Fetches members of a specific Twitter List, identified by its unique ID.

### Fetch space ticket buyers list

**Slug:** `TWITTER_FETCH_SPACE_TICKET_BUYERS_LIST`

Retrieves a list of users who purchased tickets for a specific, valid, and ticketed Twitter Space.

### Follow a list

**Slug:** `TWITTER_FOLLOW_A_LIST`

Allows 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 individual list members.

### Get followers by user id

**Slug:** `TWITTER_FOLLOWERS_BY_USER_ID`

Retrieves a list of users who follow a specified public Twitter user ID.

### Get following by user ID

**Slug:** `TWITTER_FOLLOWING_BY_USER_ID`

Retrieves users followed by a specific Twitter user, allowing pagination and customization of returned user and tweet data fields via expansions.

### Follow a user

**Slug:** `TWITTER_FOLLOW_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

**Slug:** `TWITTER_FULL_ARCHIVE_SEARCH`

Searches the full archive of public Tweets from March 2006 onwards; use 'start_time' and 'end_time' together for a defined time window.

### Get full archive search counts

**Slug:** `TWITTER_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 `start_time`/`end_time`.

### Get a user's list memberships

**Slug:** `TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS`

Retrieves all Twitter 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

**Slug:** `TWITTER_GET_A_USER_S_OWNED_LISTS`

Call this action to retrieve Lists created (owned) by a specific Twitter user, not Lists they follow or are subscribed to.

### Get a user's pinned lists

**Slug:** `TWITTER_GET_A_USER_S_PINNED_LISTS`

Retrieves the Lists a specific, existing Twitter user has pinned to their profile to highlight them.

### Get users blocked by user ID

**Slug:** `TWITTER_GET_BLOCKED_USERS`

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. Use the 'Get authenticated user' action first to obtain your user ID.

### Get DM events by ID

**Slug:** `TWITTER_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.

### Get DM events for a DM conversation

**Slug:** `TWITTER_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 list followers

**Slug:** `TWITTER_GET_LIST_FOLLOWERS`

Fetches 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.

### Get Media Upload Status

**Slug:** `TWITTER_GET_MEDIA_UPLOAD_STATUS`

Get the status of a media upload for X/Twitter. Use this to check the processing status of uploaded media, especially for videos and GIFs. Only needed if the FINALIZE command returned processing_info.

### Get muted users

**Slug:** `TWITTER_GET_MUTED_USERS`

Returns user objects muted by the X user identified by the `id` path parameter.

### Get post retweeters

**Slug:** `TWITTER_GET_POST_RETWEETERS_ACTION`

Retrieves users who publicly retweeted a specified public Post ID, excluding Quote Tweets and retweets from private accounts.

### Get recent direct message events

**Slug:** `TWITTER_GET_RECENT_DM_EVENTS`

Returns recent Direct Message events for the authenticated user, such as new messages or changes in conversation participants.

### Get user's followed lists

**Slug:** `TWITTER_GET_USER_S_FOLLOWED_LISTS`

Returns metadata (not Tweets) for lists a specific Twitter user follows, optionally including expanded owner details.

### Set reply visibility

**Slug:** `TWITTER_HIDE_REPLIES`

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). You can only hide replies to posts you authored. Note: Requires the tweet.moderate.write OAuth scope.

### Lookup list by ID

**Slug:** `TWITTER_LIST_LOOKUP_BY_LIST_ID`

Returns 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.

### List post likers

**Slug:** `TWITTER_LIST_POST_LIKERS`

Retrieves users who have liked the Post (Tweet) identified by the provided ID.

### List posts timeline by list ID

**Slug:** `TWITTER_LIST_POSTS_TIMELINE_BY_LIST_ID`

Fetches the most recent Tweets posted by members of a specified Twitter List.

### Mute user by ID

**Slug:** `TWITTER_MUTE_USER_BY_USER_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

**Slug:** `TWITTER_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

**Slug:** `TWITTER_POST_DELETE_BY_POST_ID`

Irreversibly deletes a specific Tweet by its ID; the Tweet may persist in third-party caches after deletion.

### Look up post by id

**Slug:** `TWITTER_POST_LOOKUP_BY_POST_ID`

Fetches comprehensive details for a single Tweet by its unique ID, provided the Tweet exists and is accessible.

### Get tweets by IDs

**Slug:** `TWITTER_POST_LOOKUP_BY_POST_IDS`

Retrieves detailed information for one or more Posts (Tweets) identified by their unique IDs, allowing selection of specific fields and expansions.

### Get tweets label stream

**Slug:** `TWITTER_POSTS_LABEL_STREAM`

Stream real-time Tweet label events (apply/remove). Requires Enterprise access and App-Only OAuth 2.0 auth. Returns PublicTweetNotice or PublicTweetUnviewable events. 403 errors indicate missing Enterprise access or wrong auth type.

### Fetch tweet usage data

**Slug:** `TWITTER_POST_USAGE`

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.

### Search recent tweets

**Slug:** `TWITTER_RECENT_SEARCH`

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 objects always return 'id' and 'text' by default. User objects always return 'id', 'name', and 'username' by default when expanded. Do not request these default fields in field parameters. IMPORTANT LIMITATION - Impression Counts: The public_metrics.impression_count field returns 0 for search results from other users. Impression data is a non-public metric only available for tweets owned by the authenticated user. To filter by engagement, use retweet_count, like_count, or quote_count instead. Example - Get original tweets from Elon Musk since Sept 20, 2025: { "query": "from:elonmusk -is:retweet -is:reply", "start_time": "2025-09-20T00:00:00Z", "max_results": 50, "tweet_fields": ["created_at","public_metrics","text"], "expansions": ["author_id","attachments.media_keys","referenced_tweets.id"] }

### Fetch recent tweet counts

**Slug:** `TWITTER_RECENT_SEARCH_COUNTS`

Retrieves the count of Tweets matching a specified search query within the last 7 days, aggregated by 'minute', 'hour', or 'day'.

### Remove a bookmarked post

**Slug:** `TWITTER_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.

### Remove a list member

**Slug:** `TWITTER_REMOVE_A_LIST_MEMBER`

Removes 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.

### Retrieve compliance job by id

**Slug:** `TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_ID`

Retrieves status, download/upload URLs, and other details for an existing Twitter compliance job specified by its unique ID.

### Retrieve compliance jobs

**Slug:** `TWITTER_RETRIEVE_COMPLIANCE_JOBS`

Returns a list of recent compliance jobs, filtered by type (tweets or users) and optionally by status.

### Retrieve DM conversation events

**Slug:** `TWITTER_RETRIEVE_DM_CONVERSATION_EVENTS`

Retrieves Direct Message (DM) events for a specific conversation ID on Twitter, useful for analyzing messages and participant activities.

### Retrieve posts from a space

**Slug:** `TWITTER_RETRIEVE_POSTS_FROM_A_SPACE`

Retrieves Tweets that were shared/posted during a Twitter Space broadcast. IMPORTANT: This endpoint returns Tweets that participants explicitly shared during the Space session, NOT audio transcripts, comments, or reactions. Most Spaces have zero associated Tweets, so empty results (result_count=0) are normal and expected. Twitter Spaces are primarily audio conversations - this endpoint only returns text Tweets that were shared alongside the audio.

### Retrieve posts that quote a post

**Slug:** `TWITTER_RETRIEVE_POSTS_THAT_QUOTE_A_POST`

Retrieves Tweets that quote a specified Tweet, requiring a valid Tweet ID.

### Retrieve retweets of a post

**Slug:** `TWITTER_RETRIEVE_POSTS_THAT_REPOST_A_POST`

Retrieves Tweets that Retweeted a specified public or authenticated-user-accessible Tweet ID, optionally customizing the response with fields and expansions.

### Retrieve liked tweets by user ID

**Slug:** `TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID`

Retrieves Tweets liked by a specified Twitter user, provided their liked tweets are public or accessible.

### Fetch OpenAPI specification

**Slug:** `TWITTER_RETURNS_THE_OPEN_API_SPECIFICATION_DOCUMENT`

Fetches the OpenAPI specification (JSON) for Twitter's API v2, used to programmatically understand the API's structure for developing client libraries or tools.

### Retweet post

**Slug:** `TWITTER_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.

### Search for spaces

**Slug:** `TWITTER_SEARCH_FOR_SPACES`

Searches for Twitter Spaces by a textual query, optionally filtering by state (live, scheduled, all) to discover audio conversations.

### Send a new message to a DM conversation

**Slug:** `TWITTER_SEND_A_NEW_MESSAGE_TO_A_DM_CONVERSATION`

Sends a message, with optional text and/or media attachments (using pre-uploaded `media_id`s), to a specified Twitter Direct Message conversation.

### Send a new message to a user

**Slug:** `TWITTER_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 Twitter user; this creates a new DM and does not modify existing messages.

### Look up space by ID

**Slug:** `TWITTER_SPACE_LOOKUP_BY_SPACE_ID`

Retrieves details for a Twitter Space by its ID, allowing for customization and expansion of related data, provided the Space ID is valid and accessible.

### Get spaces by creator IDs

**Slug:** `TWITTER_SPACE_LOOKUP_BY_THEIR_CREATORS`

Retrieves Twitter Spaces created by a list of specified User IDs, with options to customize returned data fields.

### Get space information by IDs

**Slug:** `TWITTER_SPACE_LOOKUP_UP_SPACE_IDS`

Fetches detailed information for one or more Twitter Spaces (live, scheduled, or ended) by their unique IDs; at least one Space ID must be provided.

### Unfollow a list

**Slug:** `TWITTER_UNFOLLOW_A_LIST`

Enables 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 success, even if the user was not initially following the list.

### Unfollow user

**Slug:** `TWITTER_UNFOLLOW_USER`

Allows the authenticated user to unfollow an existing Twitter user (`target_user_id`), which removes the follow relationship. The source user ID is automatically determined from the authenticated session.

### Unlike post

**Slug:** `TWITTER_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

**Slug:** `TWITTER_UNMUTE_USER_BY_USER_ID`

Unmutes a target user for the authenticated user, allowing them to see Tweets and notifications from the target user again. The source_user_id is automatically populated from the authenticated user's credentials.

### Unpin a list

**Slug:** `TWITTER_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

**Slug:** `TWITTER_UNRETWEET_POST`

Removes a user's retweet of a specified Post, if the user had previously retweeted it.

### Update list attributes

**Slug:** `TWITTER_UPDATE_LIST`

Updates an existing Twitter List's name, description, or privacy status, requiring the List ID and at least one mutable property.

### Upload Large Media

**Slug:** `TWITTER_UPLOAD_LARGE_MEDIA`

Use this to upload media files to X/Twitter. Automatically uses chunked upload for GIFs, videos, and images larger than 5 MB to avoid size limit errors.

### Upload Media

**Slug:** `TWITTER_UPLOAD_MEDIA`

Upload media (images only) to X/Twitter using the v2 API. This action only supports images (tweet_image, dm_image) and subtitle files. For GIFs, videos, or any file larger than ~5 MB, use TWITTER_UPLOAD_LARGE_MEDIA instead.

### Get user reverse chronological timeline

**Slug:** `TWITTER_USER_HOME_TIMELINE_BY_USER_ID`

Retrieves the home timeline (reverse chronological feed) for the authenticated Twitter user. Returns tweets from accounts the user follows as well as the user's own tweets, in reverse chronological order. Useful for displaying the personalized feed without algorithmic sorting. CRITICAL: The 'id' parameter MUST be the authenticated user's own numeric Twitter user ID - use TWITTER_USER_LOOKUP_ME to get your ID first. This endpoint cannot fetch another user's home timeline, and passing any ID that doesn't match the authenticating user (including phone numbers or other user IDs) will result in an error. DEFAULT FIELDS: Tweet objects always return 'id' and 'text' by default. User objects always return 'id', 'name', and 'username' by default when expanded. Do not request these default fields in field parameters.

### Like a tweet

**Slug:** `TWITTER_USER_LIKE_POST`

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. The authenticated user's ID is automatically determined from the OAuth token - you only need to provide the tweet_id.

### Look up user by ID

**Slug:** `TWITTER_USER_LOOKUP_BY_ID`

Retrieves 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.

### Look up users by IDs

**Slug:** `TWITTER_USER_LOOKUP_BY_IDS`

Retrieves detailed information for specified X (formerly Twitter) user IDs, optionally customizing returned fields and expanding related entities.

### Look up user by username

**Slug:** `TWITTER_USER_LOOKUP_BY_USERNAME`

Fetches 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 followed by the authenticated user.

### Look up users by username

**Slug:** `TWITTER_USER_LOOKUP_BY_USERNAMES`

Retrieves 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 like pinned tweets.

### Get authenticated user

**Slug:** `TWITTER_USER_LOOKUP_ME`

Returns profile information for the currently authenticated X user, customizable via request fields.
