N8N Tools - X (Twitter) Enhanced icon

N8N Tools - X (Twitter) Enhanced

Comprehensive X (Twitter) API v2 integration for N8N workflows

Overview

This node provides an enhanced integration with the X (formerly Twitter) API v2, allowing users to perform a wide range of operations on tweets, users, timelines, media, spaces, lists, bookmarks, direct messages, analytics, and compliance jobs. Specifically for the Tweets resource and the Unhide Reply operation, it enables users to unhide a previously hidden reply on a tweet.

Common scenarios where this node is beneficial include managing tweet visibility in social media workflows, automating moderation tasks, or integrating Twitter interactions into broader automation pipelines. For example, a user might automatically unhide replies that were mistakenly hidden or manage replies based on sentiment analysis results.

Properties

Name Meaning
Tweet ID The unique identifier of the tweet or reply to unhide.
Include Private Metrics Whether to include private metrics in responses (requires elevated access).
Custom Fields Comma-separated list of custom fields to include in the response.
Custom Expansions Comma-separated list of custom expansions to include in the response.

Output

The node outputs JSON data representing the result of the unhide reply operation. This typically includes confirmation details from the Twitter API about the reply being unhidden. The output is structured as an array of items, each containing a json field with the API response and metadata about the input item processed.

If multiple inputs are processed, the output will be an array of such results corresponding to each input.

The node does not output binary data.

Dependencies

  • Requires an active subscription and valid API key for the external "N8N Tools API" service, which validates usage before calling Twitter.
  • Requires OAuth2 or API key credentials configured in n8n for authenticating with the Twitter API.
  • Uses the bundled Twitter API client library internally to interact with Twitter endpoints.

Troubleshooting

  • Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correct and has the necessary permissions.
  • Twitter API errors: Errors returned by Twitter (e.g., invalid Tweet ID, insufficient permissions) will be surfaced. Check that the Tweet ID is correct and that the authenticated user has rights to unhide the reply.
  • Network or connectivity issues: Ensure that n8n can reach both the N8N Tools API and Twitter API endpoints.
  • Unsupported file upload method: For media operations (not relevant here), base64 encoded data must be used; URLs are not supported yet.

Links and References

Discussion