Upload Post

Overview

The "Upload Video" operation of the Upload Post node enables users to upload a single video to multiple supported social media platforms via the Upload-Post API. This node is useful for automating video content distribution across platforms such as TikTok, Instagram, LinkedIn, YouTube, Facebook, X (Twitter), Threads, and Pinterest.

Typical use cases include:

• Scheduling video posts to various social channels simultaneously.
• Automating video uploads with platform-specific metadata like descriptions, privacy settings, and tags.
• Managing asynchronous uploads with status polling to handle longer processing times without timing out.

For example, a marketing team can use this node to upload a promotional video to YouTube, Facebook, and Instagram Reels at once, setting different descriptions and privacy options per platform, and optionally scheduling the post for a future date.

Properties

Output

The node outputs JSON data representing the response from the Upload-Post API after attempting the video upload. The structure includes:

• success: Boolean indicating if the upload request was accepted successfully.
• request_id: Unique identifier for the upload request, especially important for asynchronous uploads.
• Additional fields depending on the API response, such as status, message, or error details.

If the upload is asynchronous and "Wait for Completion" is enabled, the node polls the upload status endpoint until the upload completes or times out, then returns the final status in the output.

No binary data is output by this node; all results are returned as JSON.

Dependencies

• Requires an API key credential for the Upload-Post API.
• Needs internet access to communicate with https://api.upload-post.com.
• Binary data inputs (video files, thumbnails) must be provided in the workflow's binary properties if uploading files rather than URLs.
• Proper configuration of user profiles on upload-post.com is necessary (User Identifier).
• Scheduling requires correct date-time formatting; the node appends 'Z' if missing to ensure UTC.

Troubleshooting

• Missing Binary Data: If the specified binary property for video or thumbnail is not found, the node logs a warning and may fail the upload. Ensure the binary property name matches exactly and that the previous node provides the binary data.
• Timeouts on Synchronous Uploads: Uploads taking longer than 59 seconds automatically switch to asynchronous mode. Use the returned request_id with the status endpoint to check progress.
• Invalid Platform or Missing Required Fields: Selecting unsupported platforms for the operation or omitting required fields like Facebook Page ID or User Identifier will cause errors. Double-check platform compatibility and mandatory parameters.
• Scheduling Issues: Incorrectly formatted scheduled dates may cause the API to reject the request. Always provide ISO 8601 date-time strings, preferably with timezone info or ending with 'Z'.
• API Authentication Errors: Ensure the API key credential is valid and has permissions for the requested operations.
• Polling Timeout: If waiting for completion, the node stops polling after the configured timeout and returns a timeout message. Increase the timeout or disable waiting if needed.

Links and References

• Upload-Post API Documentation
• Upload-Post Manage Users
• Social media platform developer documentation for video upload requirements (Facebook, Instagram, TikTok, YouTube, LinkedIn, X/Twitter, Threads, Pinterest)