Overview
The "Upload Post" node enables users to upload various types of social media content—photos, videos, or text posts—to multiple platforms via the Upload-Post API. It supports uploading one or more photos, a single video, or text-based posts to platforms such as Facebook, Instagram, LinkedIn, Threads, TikTok, X (Twitter), and YouTube.
This node is beneficial for automating social media publishing workflows where content needs to be distributed across multiple channels simultaneously. For example, a marketing team can use it to schedule photo posts on Instagram and Facebook, upload promotional videos to YouTube and TikTok, or publish text announcements on LinkedIn and X (Twitter) without manual intervention.
Practical examples:
- Uploading a set of product photos with captions to Instagram Stories and Facebook Pages.
- Posting a promotional video with specific privacy settings to TikTok and YouTube.
- Publishing a text announcement simultaneously on LinkedIn and X (Twitter).
Properties
| Name | Meaning |
|---|---|
| User Identifier | The 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 content will be uploaded. Options: Facebook, Instagram, LinkedIn, Threads, TikTok, X (Twitter), YouTube. |
| Title | The title of the post, video, or text content being uploaded. |
| Photos (Files or URLs) | An array of photos to upload. Each item can be a binary file reference or a direct HTTPS URL string. Multiple photos can be added. |
| Caption | Caption or description text accompanying the photo post. |
| LinkedIn Visibility | Visibility setting for LinkedIn posts. Options include Public, Connections, Logged In, Container. Applies when posting to LinkedIn. |
| Target LinkedIn Page ID | Optional LinkedIn page ID to upload content to an organization’s page instead of a personal profile. |
| Facebook Page ID | Required Facebook Page ID where the content will be posted. |
| TikTok Auto Add Music | Boolean flag indicating whether background music should be automatically added to TikTok photo posts. |
| TikTok Disable Comment | Boolean flag to disable comments on TikTok photo or video posts. |
| TikTok Branded Content (Photo) | Boolean flag indicating if the TikTok photo post is branded content (requires commercial disclosure). |
| TikTok Disclose Commercial (Photo) | Boolean flag to disclose the commercial nature of the TikTok photo post (used with branded content). |
| TikTok Photo Cover Index | Index (starting at 0) of the photo to use as the cover/thumbnail for TikTok photo posts. |
| TikTok Photo Description | Description text for TikTok photo posts; if empty, the common Title value is used. |
| Instagram Photo Media Type | Type of Instagram photo media: Image (Feed) or Stories. |
Output
The node outputs JSON data representing the response from the Upload-Post API for each input item processed. Each output item corresponds to an input item and contains the API's JSON response under the json field.
If an error occurs during processing and the node is configured to continue on failure, the output JSON will contain an error field with the error message.
The node does not output binary data.
Dependencies
- Requires an API key credential for the Upload-Post API.
- The node makes HTTP POST requests to the Upload-Post API endpoint at
https://api.upload-post.com/api. - Proper configuration of credentials with a valid API key is mandatory.
- Network access to the Upload-Post API service must be available.
Troubleshooting
- Missing API Key: If the API key credential is missing or invalid, the node throws an error stating that the API key is missing. Ensure the API key is correctly configured in the node credentials.
- Invalid Operation Routing: Errors may occur if the operation selected does not have proper routing information. This usually indicates a misconfiguration or internal issue.
- HTTP Request Failures: Network issues, invalid parameters, or API errors will result in request failures. Check the error messages returned by the API for details.
- Binary Data Handling: When uploading photos or videos as files, ensure the binary property names are correctly referenced (e.g.,
{{$binary.dataPropertyName}}). Incorrect references will cause upload failures. - Platform-Specific Requirements: Some platforms require additional properties (e.g., Facebook Page ID for Facebook posts). Omitting required fields will cause errors.
Links and References
- Upload-Post API Documentation (Assumed based on base URL, please verify actual documentation link)
- n8n Documentation on Creating Custom Nodes
- Social media platform developer portals for platform-specific requirements (Facebook, Instagram, LinkedIn, TikTok, etc.)