Actions74
- Lists Actions
- Tweets Actions
- Users Actions
- Timelines Actions
- Media Actions
- Spaces Actions
- Direct Messages Actions
- Analytics Actions
- Compliance Actions
Overview
This node provides an enhanced integration with the X (formerly Twitter) API v2, enabling a wide range of operations on Twitter resources such as Tweets, Users, Timelines, Media, Spaces, Lists, Bookmarks, Direct Messages, Analytics, and Compliance. Specifically for the Users resource and the Unblock User operation, it allows you to unblock a specified user by their user ID or username.
Common scenarios where this node is beneficial include automating social media management tasks like unblocking users who were previously blocked, managing followers, or performing bulk user-related actions within workflows. For example, if you want to automatically unblock users based on certain criteria or after a cooldown period, this node can be integrated into your workflow to perform that action programmatically.
Properties
| Name | Meaning |
|---|---|
| User ID | The ID or @username of the user to unblock. |
| 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. |
For the Unblock User operation under the Users resource, only the User ID property is required and used directly to specify which user to unblock.
Output
The output of the node is a JSON object representing the result of the unblock operation returned by the Twitter API. This typically includes confirmation details about the unblock action, such as success status or any relevant metadata provided by the API.
If multiple input items are processed, the output will be an array of such JSON objects, each corresponding to one unblock request.
The node does not output binary data for this operation.
Dependencies
- Requires an active subscription and valid API key for the external "N8N Tools API" service, which acts as a validation layer before calling Twitter.
- Requires OAuth2 or API credentials configured in n8n to authenticate with the Twitter API.
- The node depends on the bundled
twitter-apihelper class for making requests to Twitter's endpoints.
Troubleshooting
- Invalid subscription or API key error: If you receive an error indicating invalid subscription or API key, verify that your N8N Tools API credentials are correct and have the necessary permissions.
- Twitter API errors: Errors from Twitter (e.g., user not found, rate limits) will be thrown as node operation errors. Check the user ID validity and ensure your Twitter app has appropriate access.
- URL file upload not implemented: Although unrelated to unblock user, note that media uploads via URL are not supported; base64 encoded data must be used instead.
- Continue on Fail: If enabled, the node will continue processing other items even if some fail, returning error details per item.