Upload Post icon

Upload Post

Upload content to social media via Upload-Post API

Actions28

Upload → Upload Document

AI-generated

Overview

This node operation uploads a document (PDF, PPT, PPTX, DOC, DOCX) to social media platforms via the Upload-Post API, specifically supporting LinkedIn. It allows users to specify the document either as a binary file or a URL, and includes options for scheduling, queueing, and setting platform-specific metadata such as LinkedIn visibility and document description. The node handles asynchronous upload processing and can wait for completion by polling the upload status.

Use Case Examples

  1. Uploading a PDF document to LinkedIn for a scheduled post with a custom description.
  2. Uploading a DOCX file from binary data to LinkedIn immediately without scheduling.
  3. Uploading a document URL to LinkedIn and adding the post to a queue for automatic scheduling.

Properties

Name Meaning
User Identifier Name or ID Select or specify the user profile name or ID to upload the document under.
Platform Names or IDs Select one or more platforms to upload the document to, supporting LinkedIn only for documents.
Title / Main Content Title of the document post, optional for document uploads.
LinkedIn First Comment (Override) Optional override for the first comment on LinkedIn posts.
Document (File or URL) The document file to upload or a document URL. For files, specify the binary property name.
Document Description Optional description or commentary for the LinkedIn document post.
Scheduled Date Optional date/time to schedule the document upload instead of posting immediately.
Timezone Optional timezone for the scheduled date; defaults to UTC if not provided.
Add to Queue Whether to add the document post to a configured queue for automatic scheduling.
Max Posts Per Slot Maximum number of posts allowed per queue slot, overrides profile setting when queueing.
Upload Asynchronously Whether to process the upload asynchronously and return immediately.
Idempotency Key Key used by the API to prevent duplicate uploads within 24 hours.
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.
LinkedIn Visibility Visibility setting for LinkedIn document posts (e.g., Public, Connections).
Target LinkedIn Page Name or ID Select or specify the LinkedIn page to post the document to.

Output

JSON

  • request_id - Unique identifier for the upload request, used for status polling.
  • status - Current status of the upload (e.g., completed, failed).
  • message - Additional message or error information from the API response.

Dependencies

  • Upload-Post API
  • An API key credential for authentication

Troubleshooting

  • Ensure the document file or URL is correctly specified and accessible.
  • Check that the user profile and platform IDs are valid and authorized.
  • If waiting for completion, verify the poll interval and timeout settings are appropriate.
  • Handle API errors related to file size limits (max 100MB) and page limits (max 300 pages).

Links

Discussion