Actions9
- Upload Actions
- Status & History Actions
- User Actions
Overview
The "Upload Text" operation of the Upload Post node allows users to upload text-based posts to multiple supported social media platforms via the Upload-Post API. This operation is useful for automating the publishing of textual content such as announcements, updates, or promotional messages across platforms like X (Twitter), LinkedIn, Facebook, and Threads.
Typical use cases include:
- Scheduling text posts to multiple social channels simultaneously.
- Attaching links or tagging users on specific platforms.
- Managing asynchronous uploads with status polling to ensure successful posting.
For example, a marketing team can prepare a campaign message once and publish it to Facebook, LinkedIn, and Twitter at scheduled times without manual intervention.
Properties
| Name | Meaning |
|---|---|
| User Identifier | The profile name created in your upload-post.com account, identifying which user profile to post from. |
| Platform(s) | The social media platforms to upload the text post to. Supported platforms for text upload are: X (Twitter), LinkedIn, Facebook, Threads. |
| Pinterest Board ID | Target Pinterest board ID (not applicable for text upload; shown only if Pinterest platform selected). |
| Title / Main Content | The main text content of the post. This is the actual text that will be published. |
| 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 takes longer than 59 seconds, it switches automatically to async mode. |
| Wait for Completion | Whether to poll the upload status endpoint until the upload completes or times out when processed asynchronously. |
| 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. |
| Target LinkedIn Page ID | LinkedIn page ID to upload the post to an organization page instead of personal profile (optional). |
| Facebook Page ID | Facebook Page ID where the text post will be published. Required when Facebook platform is selected. |
| Facebook Link (Text) | URL to attach as a link preview to the Facebook text post. Only applicable for text uploads on Facebook. |
| X Tagged User IDs | Comma-separated list of user IDs to tag in the post on X (Twitter). Not applicable for photos. |
| X Reply Settings | Controls who can reply to the post on X (Twitter). Options: Following, Mentioned Users, Everyone. Not applicable for photos. |
| X Post URL (Text) | URL to attach to the X (Twitter) text post. Only for text uploads. |
Output
The node outputs JSON data representing the response from the Upload-Post API after attempting the text upload. The output includes:
success: Boolean indicating if the upload request was accepted.request_id: A unique identifier for the upload request, especially important if the upload is asynchronous.- Additional fields depending on the API response, such as status messages or error details.
If asynchronous upload is enabled and "Wait for Completion" is true, the node polls the upload status endpoint until the upload completes or times out, then outputs the final status.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for the Upload-Post API configured in n8n.
- Internet access to call the Upload-Post API endpoints.
- Properly configured user profiles on upload-post.com with valid platform connections.
- For Facebook and LinkedIn, relevant Page IDs must be provided.
- For asynchronous uploads, the node relies on polling the Upload-Post status endpoint.
Troubleshooting
- Missing or invalid User Identifier: Ensure the "User Identifier" matches a profile created in your upload-post.com account.
- Platform not supported for text upload: Only X, LinkedIn, Facebook, and Threads are supported for text posts. Selecting unsupported platforms will result in errors.
- Facebook Page ID required: When Facebook is selected as a platform, the Facebook Page ID must be provided.
- Timeouts during synchronous upload: If the upload takes longer than 59 seconds and asynchronous mode is disabled, the node switches to async automatically. Use the returned
request_idto check status. - Polling timeout: If "Wait for Completion" is enabled but the upload does not complete within the specified timeout, the node returns a timeout error. Increase the timeout or handle the status manually.
- Invalid URLs or tagging IDs: Ensure URLs and tagged user IDs are correctly formatted and valid for the target platform.
- API key issues: Verify that the API key credential is valid and has necessary permissions.
Links and References
- Upload-Post API Documentation
- Managing Users on Upload-Post
- Social media platform developer guidelines for posting content (e.g., Facebook Pages, Twitter/X API docs)
This summary focuses exclusively on the "Upload Text" operation under the "Upload" resource as requested.