Form-Based X/Twitter Poster

Description

🚀 Form-Based X/Twitter Poster (v2)

A user-friendly n8n workflow that enables users to submit tweets through a simple web form — with optional image, video, or GIF uploads — and posts them to a connected X/Twitter account. Designed for ease of use, this workflow handles both media and text-only posts, providing clear feedback upon submission.

🧭 Overview

Workflow Name: Form-Based X/Twitter Poster (v2)
Goal: Provide a web form for users to create tweets, upload optional media, and post directly to X/Twitter.

🛠 How It Works

1. Form Submission Trigger
Node:** On form submission
Type:** formTrigger
Purpose:** Renders a web form for tweet creation.
Fields:**
Post Content: Required textarea for tweet text.
Media: Optional file upload (.jpg, .png, .gif, .mp4, etc.).
Button:** "Submit"
Output:** JSON with text and binary media (if any).

2. Extract Media Details
Node:** Extract Media Details
Type:** code
Purpose:** Extracts tweet text, checks for media, determines media type.
Output Example:**
{
"content": "My tweet!",
"mime_type": "image/jpeg",
"media_type": "IMAGE"
}

3. If Media Exists
Node:** If Media Exists
Type:** if
Purpose:** Checks whether media was uploaded.
True Path:** Media was uploaded.
False Path:** No media uploaded.

4. Upload Media to X/Twitter (True path only)
Node:** Upload Media (X)
Type:** httpRequest
Purpose:** Uploads media to Twitter via API v1.1.
Media Category:** TWEET_IMAGE (can be customized)
Auth:** Twitter OAuth1 API
Output:** Includes media_id_string

5. Post Tweet with Media (True path)
Node:** X
Type:** twitter
Purpose:** Posts tweet with uploaded media.
Auth:** Twitter OAuth2 API

6. Post Text-Only Tweet (False path)
Node:** X1
Type:** twitter
Purpose:** Posts tweet without media.
Auth:** Twitter OAuth2 API

7. Show Confirmation Message
Node:** End Form
Type:** form
Purpose:** Displays thank-you message post-submission.
Title:** Thank you so much for sharing your experience on X! 🖤
Message:** We truly appreciate your support and are so glad we could make a positive impact. Your words mean the world to us!

🛠 How to Customize

Form Fields:** Change form title, labels, help texts, or file formats.
Media Logic:**
Add logic for distinguishing GIF vs VIDEO.
Adjust media upload URL dynamically:
https://upload.twitter.com/1.1/media/upload.json?media_category={{ $json.media_type === 'VIDEO' ? 'TWEET_VIDEO' : ($json.media_type === 'GIF' ? 'TWEET_GIF' : 'TWEET_IMAGE') }}
Error Handling:** Add Error Trigger nodes to catch and manage failures gracefully.
Tweet Text:** Customize tweet text with extra formatting or default content.
Advanced Ideas:**
Schedule tweets
Post to multiple accounts
Add content approval steps

🔐 Required Credentials

1. Twitter OAuth1 API
Used by:** Upload Media (X)
Required for:** Media upload via v1.1
Credentials:** Consumer Key, Consumer Secret, Access Token, Access Token Secret
Workflow Credential Name:** X OAuth - Akhil

2. Twitter OAuth2 API
Used by:** X, X1
Required for:** Posting tweets
Scopes:** tweet.read, tweet.write, users.read, offline.access
Workflow Credential Name:** X OAuth2 - Akhil

💡 Use Cases

Easy Tweet Tool:** For non-technical users to share content.
Content Approval:** Internal review system before posting.
Announcements:** Quickly broadcast updates.
Campaign Posting:** Streamline recurring content sharing.

🧑‍💻 Node Naming Suggestions

| Old Name | Suggested Name |
|--------------------|--------------------------|
| If Image Exists | If Media Exists |
| X | Post Tweet with Media |
| X1 | Post Text-Only Tweet |

❤️ Made with love by Akhil using n8n