Upload Post icon

Upload Post

Upload content to social media via Upload-Post API

Actions9

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 asynchronous uploads with optional polling for completion status and scheduling posts for future publication.

This node is beneficial in scenarios such as:

  • Automating social media marketing by posting images, videos, or text across platforms like TikTok, Instagram, LinkedIn, Facebook, Twitter (X), Threads, Pinterest, and YouTube.
  • Scheduling posts ahead of time to maintain consistent engagement.
  • Managing multi-platform campaigns from a single workflow.
  • Tracking upload status asynchronously to handle longer processing times without blocking workflows.

Practical examples:

  • Uploading a batch of photos to Instagram and Facebook simultaneously with captions.
  • Posting a scheduled video to YouTube and TikTok with platform-specific metadata.
  • Publishing a text announcement on LinkedIn and Twitter with tagging and reply settings.
  • Checking the status of an asynchronous upload using the returned request ID.

Properties

Name Meaning
User Identifier The profile name created in your upload-post.com account, identifying which user profile to use for uploading.
Platform(s) List of social media platforms to upload to. Options include Facebook, Instagram, LinkedIn, Pinterest, Threads, TikTok, X (Twitter), and YouTube.
Pinterest Board ID Target Pinterest board ID; required if Pinterest is selected as a platform.
Title / Main Content Title of the post or main text content. For videos, acts as fallback description if none provided.
Scheduled Date Optional date/time to schedule the post instead of immediate publishing.
Upload Asynchronously Whether to process the upload asynchronously and return immediately. If false but upload exceeds 59 seconds, it switches to async automatically.
Wait for Completion When uploading asynchronously, whether to poll the status endpoint until completion or timeout.
Poll Interval (Seconds) How often (in seconds) to poll the status endpoint when waiting for completion.
Timeout (Seconds) Maximum time (in seconds) to wait before giving up polling for completion.
Photos (Files or URLs) Comma-separated list of photo files (binary property names) or direct HTTP/HTTPS URLs to upload.
Caption (Photo/Video) General caption or commentary for photo or video posts. Not used for text posts.
LinkedIn Visibility Visibility setting for LinkedIn posts. For photos: only Public supported. For videos: Public, Connections, Logged In, Container.
Target LinkedIn Page ID Optional LinkedIn page ID to upload to an organization page.
Facebook Page ID Required Facebook Page ID for uploads to Facebook.
TikTok Auto Add Music For TikTok photo uploads, whether to auto add music.
TikTok Disable Comment Whether to disable comments on TikTok posts (photos and videos).
TikTok Branded Content For TikTok photo uploads, whether to mark as branded content (requires commercial disclosure).
TikTok Disclose Commercial For TikTok photo uploads, whether to disclose commercial nature.
TikTok Photo Cover Index Index (0-based) of photo to use as cover for TikTok photo posts.
TikTok Photo Description Description for TikTok photo post; falls back to Title if not provided.
Instagram Media Type Type of media for Instagram uploads: Image (Feed - Photo), Stories (Photo/Video), or Reels (Video).

Additional platform-specific properties exist for video uploads (e.g., YouTube tags, privacy settings, Instagram collaborators) and text uploads (e.g., Facebook link, X tagged user IDs), but are outside the scope of this resource-operation focus.

Output

The node outputs JSON data representing the response from the Upload-Post API for each input item processed. This includes:

  • Success status and messages.
  • Request IDs for asynchronous uploads.
  • Detailed upload status information when polling is enabled.
  • Metadata about the uploaded content as returned by the API.

If the upload is asynchronous and waitForCompletion is true, the node polls the status endpoint until the upload completes or times out, then outputs the final status.

Binary data is handled internally for file uploads but is not outputted by the node; the output focuses on API response data.

Dependencies

  • Requires an API key credential for the Upload-Post API.
  • Network access to https://api.upload-post.com.
  • Properly configured binary data inputs for file uploads (photos, videos, thumbnails).
  • The node uses internal helper methods to fetch binary data buffers from input items.

Troubleshooting

  • Missing Binary Data: If a specified binary property for a photo, video, or thumbnail is not found in the input item, the node logs a warning and skips that file. Ensure binary data is correctly attached and named.
  • Timeouts on Synchronous Uploads: Setting uploadAsync to false may cause timeouts if uploads take longer than 59 seconds. Use asynchronous mode or enable polling to avoid this.
  • Invalid Platform or Missing Required Fields: Selecting unsupported platforms for an operation or omitting required fields like Facebook Page ID or Pinterest Board ID will cause API errors. Verify all required parameters per platform.
  • Polling Timeouts: If waitForCompletion is enabled but the upload does not complete within the pollTimeout, the node returns a timeout error message. Adjust polling interval and timeout as needed.
  • API Authentication Errors: Ensure the API key credential is valid and has necessary permissions.

Links and References

Discussion