Upload Post icon

Upload Post

Upload content to social media via Upload-Post API

Actions3

Overview

The Upload Post node enables users to upload content such as photos, videos, or text posts to multiple social media platforms through the Upload-Post API. It supports a variety of platforms including Facebook, Instagram, LinkedIn, Threads, TikTok, X (Twitter), and YouTube.

This node is beneficial for automating social media publishing workflows where content needs to be posted simultaneously or selectively across different platforms. For example, a marketing team can use this node to schedule and publish promotional videos on YouTube and Instagram Reels, or share photo albums on Facebook and TikTok with appropriate captions and settings.

Practical examples:

  • Uploading a set of photos with captions to Facebook and Instagram.
  • Posting a video with specific privacy settings to TikTok and YouTube.
  • Publishing a text-based announcement post to LinkedIn and Threads.

Properties

Name Meaning
User Identifier The user ID associated with the Upload-Post account to identify who is uploading the content.
Platform(s) Select 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.

Additional properties depend on the selected operation:

Common Operations

  • Upload Photo(s)

    • Photos (Files or URLs): Array of photo files (binary data) or direct HTTPS URLs.
    • Caption: Description or commentary for the photos.
    • Platform-specific options like Facebook Page ID, Instagram media type, TikTok branded content flags, etc.

  • Upload Video

    • Video (File or URL): Single video file (binary) or direct URL.
    • Platform-specific options such as visibility settings, descriptions, tags, privacy levels, and other metadata for each platform (e.g., YouTube category, TikTok duet/stitch disable flags).

  • Upload Text

    • Text content to post.
    • Platform-specific options like tagged user IDs for X (Twitter), reply settings, and post URLs.

Many platform-specific fields are available to customize the upload according to the requirements of each social network, such as visibility controls on LinkedIn, page IDs on Facebook, or privacy settings on TikTok and YouTube.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains the response from the Upload-Post API in its json field.

Example structure of one output item:

{
  "json": {
    // Response data from Upload-Post API, e.g.:
    "postId": "123456789",
    "status": "success",
    "platform": "facebook",
    "message": "Photo uploaded successfully"
  },
  "pairedItem": 0
}

If the node encounters an error and is configured to continue on failure, the output will contain an error message in the json.error field instead.

The node does not output binary data directly; it only sends binary data as part of the request payload when uploading files.

Dependencies

  • Requires an API key credential for the Upload-Post API.
  • The node makes HTTP requests to https://api.upload-post.com/api.
  • Proper configuration of credentials in n8n is necessary to authenticate requests.
  • Input binary data (photos/videos) must be provided correctly if uploading files rather than URLs.

Troubleshooting

  • Missing API Key Error: If the API key credential is not set or missing, the node will throw an error indicating that the API key is missing. Ensure the Upload-Post API credential is configured properly in n8n.

  • Routing Information Missing: If the selected operation does not have routing details (URL or method), the node will throw an error. This usually indicates a misconfiguration or unsupported operation.

  • Invalid File/Binary Data: When uploading photos or videos as files, ensure the binary property names are correct and the data is accessible. Incorrect binary references or empty data may cause upload failures.

  • Platform-Specific Errors: Some platforms require additional mandatory fields (e.g., Facebook Page ID). Omitting these may result in API errors. Review platform-specific required properties carefully.

  • Continue On Fail Behavior: If enabled, the node will output error messages per item instead of stopping execution, allowing partial success in batch operations.

Links and References

  • Upload-Post API Documentation (Assumed based on base URL, please verify actual documentation link)
  • Social media platform developer guidelines for content upload (Facebook, Instagram, LinkedIn, TikTok, YouTube, Twitter/X)

This summary is based on static analysis of the node's source code and provided property definitions. Runtime behavior depends on the actual API responses and environment setup.

Discussion