Form-based X/Twitter poster

🚀 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