Overview
This node enables users to publish posts to various social media platforms through a unified interface. It supports multiple platforms including Twitter (X), LinkedIn, Facebook, Instagram, Pinterest, TikTok, Threads, Bluesky, YouTube, and also allows sending post data to a custom webhook URL.
Common scenarios for this node include:
- Automating social media content publishing across different platforms from a single workflow.
- Scheduling posts to be published at a future date and time.
- Creating threaded posts on platforms that support threads (e.g., Twitter, Bluesky, Threads).
- Customizing posts with media URLs hosted on a specific domain.
- Sending post data to external services via webhooks.
Practical examples:
- A marketing team can schedule and publish promotional posts simultaneously on Facebook, LinkedIn, and Instagram.
- A content creator can publish a video to YouTube with specified privacy settings and notify subscribers automatically.
- A developer can send post data to a custom webhook for further processing or integration with other systems.
Properties
| Name | Meaning |
|---|---|
| Platform | The social media platform to publish the post to. Options: X (Twitter), LinkedIn, Facebook, Instagram, Pinterest, TikTok, Threads, Bluesky, YouTube, Webhook. |
| Post Text | The main text content of the post. |
| Media URLs | Comma-separated URLs of media files to include in the post. These must be hosted on the blotato.com domain. |
| Account ID | Optional ID of the connected account to publish from. If left blank, the node uses the ID stored in credentials. |
| Schedule Post | Boolean flag indicating whether to schedule the post for a future time. |
| Scheduled Time | The date and time when the post should be published. Required if scheduling is enabled. |
| Create Thread | Boolean flag to create a thread with additional posts. Available only for Twitter, Bluesky, and Threads platforms. |
| Additional Posts | Collection of additional posts forming the thread. Each includes text and optional media URLs. Only shown if "Create Thread" is true and platform supports threads. |
| Facebook Page ID | ID of the Facebook Page to post to. If left blank, uses the ID from credentials. Only shown for Facebook platform. |
| LinkedIn Page ID | Optional LinkedIn Page ID to post to a page instead of personal profile. Only shown for LinkedIn platform. |
| Pinterest Board ID | ID of the Pinterest board to post to. If left blank, uses the ID from credentials. Only shown for Pinterest platform. |
| Pin Title | Title for the Pinterest pin. Optional. Only shown for Pinterest platform. |
| Pin Alt Text | Alternative text for the Pinterest pin. Optional. Only shown for Pinterest platform. |
| Pin URL | URL linked from the Pinterest pin. Optional. Only shown for Pinterest platform. |
| TikTok Privacy Level | Privacy level of the TikTok post. Options: Public, Followers Only, Friends Only, Private. Only shown for TikTok platform. |
| TikTok Options | Additional TikTok-specific options including disabling comments, duet, stitch; marking as branded content, your brand, or AI generated. Only shown for TikTok platform. |
| Reply Control | Controls who can reply to a Threads post. Options: Everyone, Accounts You Follow, Mentioned Only. Only shown for Threads platform. |
| Video Title | Title for the YouTube video. Required for YouTube platform. |
| Privacy Status | Privacy status of the YouTube video. Options: Public, Private, Unlisted. Required for YouTube platform. |
| Notify Subscribers | Whether to notify subscribers about the new YouTube video. Default is true. Only shown for YouTube platform. |
| Webhook URL | URL of the webhook to send the post data to. Required for Webhook platform. |
Output
The node outputs an array of JSON objects corresponding to each input item processed. Each output object contains:
success: Boolean indicating if the post submission was successful.postSubmissionId: Unique identifier of the submitted post (present if successful).platform: The platform to which the post was published.scheduledTime: The scheduled time for the post if applicable, otherwise null.error: Error message string if the post failed to submit.
If the node is configured to continue on failure, errors are returned per item without stopping execution.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for the Blotato API service to authenticate requests.
- Media URLs included in posts must be hosted on the blotato.com domain.
- For some platforms, specific account or page IDs must be provided either in credentials or directly in node parameters.
- Scheduling requires valid date-time input.
- The node makes HTTP POST requests to the Blotato API endpoint
/poststo submit posts.
Troubleshooting
- Missing Account/Page IDs: Errors occur if required account or page IDs are not provided either in node parameters or credentials. Ensure these IDs are set correctly.
- Invalid Media URLs: Media URLs must be comma-separated and hosted on blotato.com. Using invalid or unsupported URLs may cause failures.
- Scheduling Errors: If scheduling is enabled but no scheduled time is provided, the node will throw an error.
- Unsupported Platforms: Providing unsupported platform values will result in errors.
- API Request Failures: Network issues or invalid API credentials will cause request failures. Verify API key validity and network connectivity.
- Thread Creation: When creating threads, ensure additional posts have valid text content; empty texts will cause errors.
Links and References
- Blotato API Documentation (hypothetical link)
- Social media platform official documentation for posting APIs (e.g., Twitter API, Facebook Graph API, YouTube Data API)
- n8n documentation on using credentials and scheduling nodes