N8N Tools - X (Twitter) EnhancedInstall

Overview

This node integrates with the X (formerly Twitter) API v2 to perform various operations related to Twitter Lists, including adding members to a list. Specifically, the "Add List Member" operation allows you to add a user to an existing Twitter List by specifying the List ID and the User ID.

This node is beneficial in scenarios where you want to automate the management of Twitter Lists within your workflows. For example, you can automatically add new followers or specific users to curated lists for targeted content curation, monitoring, or engagement purposes.

Practical example:

• Automatically add a user to a marketing campaign list when they engage with your tweets.
• Maintain a list of influencers by programmatically adding users based on certain criteria.

Properties

(Note: Although the provided JSON only includes "List ID", the code shows that the "userId" parameter is also required for this operation, representing the User ID of the member to add.)

Additional implicit input property used in this operation:

Output

The output is a JSON object containing the response from the Twitter API after attempting to add the user to the list. This typically includes confirmation details about the updated list membership or relevant metadata returned by the API.

If the operation fails and "Continue On Fail" is enabled, the output will include an error message describing the failure for each item processed.

No binary data output is involved in this operation.

Dependencies

• Requires an active subscription and valid API key for the external N8N Tools API service, which validates usage before forwarding requests to Twitter.
• Requires OAuth2 credentials or API authentication tokens configured in n8n to access the Twitter API.
• The node uses the bundled twitter-api helper class to interact with Twitter's endpoints.

Troubleshooting

• Invalid Subscription or API Key: If the N8N Tools API validation fails with 401 or 403 errors, verify that your API key credential is correct and your subscription is active.
• Missing Required Parameters: Ensure both "List ID" and "User ID" are provided; missing these will cause the Twitter API call to fail.
• Permission Issues: The authenticated Twitter account must have permission to modify the specified list; otherwise, the API will return authorization errors.
• API Rate Limits: Frequent calls may hit Twitter API rate limits; handle such errors by implementing retries or backoff strategies.
• Unhandled Errors: If "Continue On Fail" is disabled, any error will stop execution; enable it to process multiple items even if some fail.

Links and References

• Twitter API v2 Documentation - Lists
• Twitter API v2 - Add List Member Endpoint
• n8n Documentation