Actions28
- Upload Actions
- Instagram Actions
- Status & History Actions
- User Actions
Upload → Upload Text
AI-generatedOverview
This node uploads text-based posts to various social media platforms using the Upload-Post API. It supports posting text content with optional titles, first comments, scheduling, and platform-specific overrides. It is useful for automating text content publishing across platforms like X (Twitter), LinkedIn, Facebook, Threads, Discord, Telegram, and others.
Use Case Examples
- Automate posting a text update to LinkedIn and Facebook simultaneously.
- Schedule a text post with a first comment on Instagram and Threads.
- Publish a text announcement with platform-specific titles and links on multiple social media accounts.
Properties
| Name | Meaning |
|---|---|
| User Identifier Name or ID | Select or specify the user profile name or ID to post from. |
| Platform Names or IDs | Select one or more social media platforms to post the text content to. |
| Title / Main Content | The main text content or title of the post, required for some platforms like YouTube and Reddit. |
| First Comment | Text to post as the first comment or reply immediately after publishing, supported on several platforms. |
| Scheduled Date | Optional date/time to schedule the post instead of posting immediately. |
| Timezone | Optional timezone for the scheduled date; defaults to UTC if not provided. |
| Add to Queue | Whether to add the post to a configured queue for automatic scheduling instead of immediate posting. |
| Max Posts Per Slot | Maximum number of posts allowed per queue slot; overrides profile setting when adding to queue. |
| Upload Asynchronously | Whether to process the upload asynchronously and return immediately. |
| Idempotency Key | Key used by the API to prevent duplicate uploads within 24 hours; auto-generated if left empty. |
| Wait for Completion | Whether to wait and perform status checks within the node until the upload completes. |
| Poll Interval (Seconds) | Interval in seconds between status checks when waiting for completion. |
| Timeout (Seconds) | Maximum time in seconds to wait for completion before giving up. |
| Facebook Page Name or ID | Select or specify the Facebook page to post to, if posting on Facebook platform. |
| LinkedIn Page Name or ID | Select or specify the LinkedIn page to post to, if posting on LinkedIn platform. |
| Facebook Link (Text) | URL to attach as a link preview in Facebook text posts. |
| LinkedIn Link (Text) | URL to attach as a link preview card in LinkedIn text posts. |
| Bluesky Link (Text) | URL to attach as an external embed link preview card in Bluesky text posts. |
| Threads Long Text as Single Post | Whether to publish long text as a single post or split into a thread on Threads platform. |
| Threads Topic Tag | A topic tag to increase reach on Threads platform. |
| Google Business Location ID | Location ID for Google Business Profile posts with multiple locations. |
| Google Business Post Type | Type of Google Business post to publish (Standard, Event, Offer). |
| Google Business Media URL | URL of media attached to Google Business post. |
| Google Business Media Format | Format of attached media (Photo, Video, or Not Set). |
| Google Business Call to Action | Button shown under Google Business post (e.g., Book, Call, Learn More). |
| Google Business Call to Action URL | URL the call-to-action button opens. |
| Google Business Event Title | Title of the event (for Event post type). |
| Google Business Event Start Date | Start date of the event (for Event post type). |
| Google Business Event Start Time | Start time of the event (for Event post type). |
| Google Business Event End Date | End date of the event (for Event post type). |
| Google Business Event End Time | End time of the event (for Event post type). |
| Google Business Offer Coupon | Coupon code for the offer (for Offer post type). |
| Google Business Offer Redeem URL | URL where the offer is redeemed (for Offer post type). |
| Google Business Offer Terms | Terms and conditions of the offer (for Offer post type). |
| Reddit Subreddit | Destination subreddit for Reddit posts. |
| Reddit Flair ID | ID of the flair template to apply to Reddit posts. |
| Reddit Link URL | URL for Reddit link posts instead of text posts. |
| X Reply Settings | Who can reply to the post on X (Twitter). |
| X Nullcast | Whether to publish X (Twitter) post without broadcasting (promoted-only). |
| X Poll Duration (Minutes) | Duration of poll in minutes for X (Twitter) posts with polls. |
| X Poll Options | Comma-separated list of poll options for X (Twitter) posts. |
| X Poll Reply Settings | Who can reply to the poll in X (Twitter) posts. |
| X Post URL (Text) | URL to attach to the X (Twitter) text post. |
| X Quote Tweet ID | ID of the tweet to quote in a quote tweet. |
| X Geo Place ID | Geographic place ID to add location to the tweet. |
| X For Super Followers Only | Whether the tweet is exclusive for super followers. |
| X Community ID | Community ID for posting in specific communities on X (Twitter). |
| X Share with Followers | Whether to share community post with followers on X (Twitter). |
| X Direct Message Deep Link | Link to take the conversation from public timeline to private Direct Message on X (Twitter). |
| X Card URI | URI of card for Twitter Cards, ads, or promoted content. |
| X Long Text as Single Post | Whether to post long text as a single post instead of splitting into a thread on X (Twitter). |
Output
JSON
request_id- Unique identifier for the upload request, used to track status.status- Current status of the upload (e.g., completed, failed, scheduled).platforms- List of platforms the text post was uploaded to.post_url- URL of the published post if available.error_message- Error message if the upload failed.
Dependencies
- Upload-Post API
- API authentication token or API key credential
Troubleshooting
- Ensure the user profile and platform selections are correct and authorized.
- Check that required fields like title or main content are provided for platforms that require them.
- If asynchronous upload is enabled, use the returned request_id with the Upload Status endpoint to check the upload status.
- Common errors include invalid platform IDs, missing required parameters, or API authentication failures. Verify credentials and input data.
- Timeouts may occur if waiting for completion is enabled; consider using separate status check nodes for long polling.
Links
- Upload-Post API Documentation - Official API documentation for Upload-Post service.
- n8n Expressions - Guide on using expressions in n8n for dynamic parameter values.