Upload Post icon

Upload Post

Upload content to social media via Upload-Post API

Actions28

Upload → Upload Photo(s)

AI-generated

Overview

This node uploads one or more photos to various social media platforms using the Upload-Post API. It supports multiple platforms including TikTok, Instagram, LinkedIn, Facebook, X (Twitter), Threads, Discord, Telegram, Pinterest, Reddit, Bluesky, and Google Business. Users can specify the profile to post from, platforms to post to, titles, descriptions, scheduling options, and platform-specific overrides. The node can handle both file uploads (binary data) and URLs for photos, supports asynchronous uploads, and can wait for upload completion with polling.

Use Case Examples

  1. Automatically post a batch of photos to Instagram, Facebook, and Pinterest from a workflow.
  2. Schedule photo posts to multiple platforms with custom titles and first comments.
  3. Upload photos from URLs or binary data and add platform-specific descriptions and alt text.

Properties

Name Meaning
User Identifier Name or ID Select or specify the user profile name or ID to post from.
Platform Names or IDs Select one or more social media platforms to upload photos to.
Title / Main Content Title of the post, required or optional depending on platform.
First Comment Text to post as the first comment immediately after publishing.
Alt Text (Extended) Alternative text for images, supported on LinkedIn, Pinterest, and others.
Photos (Files or URLs) Comma-separated list of photo files (binary property names) or direct URLs to upload.
Scheduled Date Optional date/time to schedule the post instead of immediate publishing.
Timezone Timezone for the scheduled date; defaults to UTC if not provided.
Add to Queue Whether to add the post to a configured queue for automatic scheduling.
Max Posts Per Slot Maximum posts allowed per queue slot; overrides profile setting when queuing.
Upload Asynchronously Whether to process the upload asynchronously and return immediately.
Idempotency Key Key to prevent duplicate uploads within 24 hours; auto-generated if empty.
Autogenerate Copy With AI Whether to use AI to generate native per-platform titles and descriptions.
Wait for Completion Whether to wait and poll for upload completion status within the node.
Poll Interval (Seconds) Interval in seconds between status checks when waiting for completion.
Timeout (Seconds) Maximum time in seconds to wait for upload completion before giving up.
Platform-Specific Overrides Optional overrides for titles, descriptions, first comments, and other platform-specific fields.

Output

JSON

  • request_id - Unique identifier for the upload request, used for status checks.
  • status - Current status of the upload (e.g., completed, failed, scheduled).
  • platforms - List of platforms the photos were uploaded to.
  • details - Additional details or response data from the upload operation.

Dependencies

  • Upload-Post API authentication token

Troubleshooting

  • Ensure the user profile and platform selections are valid and authorized.
  • Verify that photo files or URLs are correctly specified and accessible.
  • Check API rate limits and authentication credentials if uploads fail.
  • If asynchronous upload is enabled, use the request_id with the Upload Status endpoint to monitor progress.
  • For scheduling posts, ensure the scheduled date and timezone are correctly formatted.

Links

Discussion