Overview
The "Upload Post" node enables users to upload various types of content—photos, videos, or text posts—to multiple social media platforms through the Upload-Post API. It supports uploading to platforms such as Facebook, Instagram, LinkedIn, Threads, TikTok, X (Twitter), and YouTube.
This node is beneficial for automating social media content publishing workflows where a single interface can manage multi-platform posting. For example, a marketing team can schedule and publish a promotional video simultaneously on Facebook, Instagram Reels, TikTok, and YouTube without manually uploading to each platform.
Specifically, the Upload Video operation allows uploading a single video file or URL with rich metadata and platform-specific options like privacy settings, descriptions, tags, and visibility controls.
Properties
| Name | Meaning |
|---|---|
| User Identifier | The unique identifier of the user in the Upload-Post system who is uploading the content. |
| Platform(s) | One or more social media platforms to which the video will be uploaded. Options: Facebook, Instagram, LinkedIn, Threads, TikTok, X (Twitter), YouTube. |
| Title | The title of the video post. |
| Video (File or URL) | The video to upload, either as a binary file reference or a direct URL starting with "http". |
| LinkedIn Visibility | Visibility setting for LinkedIn posts. Options: Public, Connections, Logged In, Container. Only applicable if LinkedIn is selected as a platform. |
| Target LinkedIn Page ID | Optional LinkedIn page ID to upload the video to an organization’s page instead of a personal profile. |
| LinkedIn Description | Commentary or description for the LinkedIn post. If omitted, the title is used. |
| Facebook Page ID | Required Facebook Page ID where the video will be posted. |
| Facebook Video Description | Description of the video for Facebook. Defaults to title if not provided. |
| Facebook Video State | Desired state of the Facebook video: Published, Draft, or Scheduled. |
| TikTok Disable Comment | Whether comments are disabled on the TikTok video post (true/false). |
| TikTok Privacy Level | Privacy setting for TikTok video. Options: Public to Everyone, Mutual Follow Friends, Follower of Creator, Self Only. |
| TikTok Disable Duet | Whether duet feature is disabled for the TikTok video (true/false). |
| TikTok Disable Stitch | Whether stitch feature is disabled for the TikTok video (true/false). |
| TikTok Cover Timestamp (Ms) | Timestamp in milliseconds specifying the cover frame for the TikTok video. |
| TikTok Brand Content Toggle | Enables branded content flag for TikTok video (true/false). |
| TikTok Brand Organic | Enables organic branded content for TikTok video (true/false). |
| TikTok Branded Content (Video) | Enables branded content disclosure for TikTok video (true/false). |
| TikTok Brand Organic Toggle | Enables toggle for organic branded content on TikTok video (true/false). |
| TikTok Is AIGC | Indicates if the TikTok content is AI-generated (true/false). |
| Instagram Video Media Type | Type of Instagram video media: Reels or Stories. |
| Instagram Share to Feed | Whether to share the Instagram video to the feed (true/false). |
| Instagram Collaborators | Comma-separated list of Instagram usernames to tag as collaborators. |
| Instagram Cover URL | URL for a custom video cover image on Instagram. |
| Instagram Audio Name | Name of the audio track associated with the Instagram video. |
| Instagram User Tags | Comma-separated list of user tags for the Instagram video. |
| Instagram Location ID | Instagram location ID to associate with the video. |
| Instagram Thumb Offset | Timestamp offset for the video thumbnail on Instagram. |
| YouTube Description | Description of the YouTube video. Defaults to title if empty. |
| YouTube Tags | Comma-separated list of tags for the YouTube video; converted to an array before sending. |
| YouTube Category ID | Numeric category ID for the YouTube video (default is "22"). |
| YouTube Privacy Status | Privacy setting for YouTube video: Public, Unlisted, or Private. |
| YouTube Embeddable | Whether the YouTube video is embeddable (true/false). |
| YouTube License | License type for the YouTube video: Standard YouTube License or Creative Commons - Attribution. |
| YouTube Public Stats Viewable | Whether public stats are viewable for the YouTube video (true/false). |
| YouTube Made For Kids | Whether the YouTube video is marked as made for kids (true/false). |
| Threads Description | Commentary for the Threads post. Defaults to title if empty. |
| X Tagged User IDs | Comma-separated list of user IDs to tag in X (Twitter) video/text posts; converted to an array before sending. |
| X Reply Settings | Who can reply to the X (Twitter) post: Following, Mentioned Users, or Everyone. |
| X Nullcast (Video) | Whether to publish the X (Twitter) video without broadcasting (true/false). |
| X Place ID (Video) | Location place ID for the X (Twitter) video. |
| X Poll Duration (Minutes, Video) | Duration in minutes for poll attached to X (Twitter) video post. Requires poll options. |
| X Poll Options (Video) | Comma-separated list of poll options for X (Twitter) video post; converted to an array before sending. |
| X Poll Reply Settings (Video) | Who can reply to the poll in X (Twitter) video post: Following, Mentioned Users, or Everyone. |
Output
The node outputs an array of JSON objects corresponding to each input item processed. Each output object contains the response from the Upload-Post API after attempting to upload the video content. The structure of the json output depends on the API response but generally includes details about the uploaded post such as post IDs, status, URLs, or error messages.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for the Upload-Post API.
- The node makes HTTP POST requests to
https://api.upload-post.com/api/uploadendpoint for video uploads. - Proper configuration of credentials with a valid API key is mandatory.
- Network access to the Upload-Post API endpoint must be available.
Troubleshooting
Missing API Key Error:
If the API key credential is missing or invalid, the node throws an error indicating the absence of the API key. Ensure that the API key credential is correctly configured and assigned.Routing Information Missing:
If the operation's routing information (URL or method) is incomplete or missing, the node will throw an error. This usually indicates misconfiguration or code issues.Invalid Input Data:
Providing invalid video references (e.g., incorrect binary property names or malformed URLs) may cause the API request to fail. Verify that the video input is either a valid URL starting with "http" or a correct binary property name.Platform-Specific Errors:
Some platforms require additional mandatory fields (e.g., Facebook Page ID for Facebook uploads). Omitting these required properties will result in errors from the API.Continue On Fail Behavior:
If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON for failed items.
Links and References
- Upload-Post API Documentation (Assumed based on base URL)
- Social media platform developer documentation for specific upload requirements (Facebook, Instagram, LinkedIn, TikTok, YouTube, X/Twitter)
- n8n documentation on Credentials and HTTP Request Node for understanding API integrations