Overview
This node integrates with the Blotato API to create social media posts across multiple platforms such as Instagram, Facebook, Twitter, TikTok, YouTube, Pinterest, LinkedIn, Bluesky, and Threads. It allows users to compose text posts, attach media URLs, and optionally create threaded posts (long-form multi-part posts) on supported platforms. The node supports platform-specific options like privacy settings for TikTok, scheduling posts, posting to specific pages or boards, and controlling reply permissions on Threads.
Common scenarios include:
- Automating social media content publishing from workflows.
- Scheduling posts with rich media attachments.
- Creating multi-part threads on platforms like Twitter or Bluesky.
- Posting videos with detailed metadata on YouTube.
- Managing posts across multiple accounts and platforms from a single node.
Example: A user can create an Instagram reel post with images and text, or schedule a YouTube video upload with privacy settings and subscriber notifications.
Properties
| Name | Meaning |
|---|---|
| Platform | Social media platform to post on. Options: Bluesky, Facebook, Instagram, Linkedin, Pinterest, Threads, Tiktok, Twitter, Youtube. |
| Account | The Blotato social media account ID to use for posting. |
| Text | Main text content of the post. |
| Media URLs | Comma-separated list of media URLs to attach to the post. Required for Instagram, TikTok, Pinterest, and YouTube posts. |
| Thread (Optional) | Method to create a long-form thread on Twitter, Threads, or Bluesky: Manual (add each post manually) or From Data (use array data from previous node). |
| Thread Posts (Manual) | Collection of additional posts in the thread, each with text and optional media URLs (comma-separated). |
| Thread Posts (From Data) | JSON array string of posts from previous node, each item with "text" (string) and optional "mediaUrls" (array of strings). |
| Privacy Level (TikTok) | Privacy setting for TikTok posts. Options: Self Only, Public to Everyone, Mutual Follow Friends, Follower of Creator. |
| Disable Comments (TikTok) | Boolean to disable comments on TikTok post. |
| Disable Duet (TikTok) | Boolean to disable duet feature on TikTok post. |
| Disable Stitch (TikTok) | Boolean to disable stitch feature on TikTok post. |
| Is Branded Content (TikTok) | Boolean indicating if the TikTok post contains branded content. |
| Is Your Brand (TikTok) | Boolean indicating if the TikTok post is about your own brand. |
| Is AI Generated (TikTok) | Boolean indicating if the TikTok content is AI generated. |
| Auto Add Music (TikTok) | Boolean to automatically add music to TikTok slideshows. |
| Facebook Page | Facebook Page ID to post to (required for Facebook platform). |
| Pinterest Board | Pinterest Board ID to pin to (required for Pinterest platform). Must have at least one image in media URLs. |
| Pin Title (Pinterest) | Optional title for the Pinterest pin. |
| Video Title (YouTube) | Title of the YouTube video (required for YouTube platform). |
| Privacy Status (YouTube) | Privacy setting for YouTube video. Options: Public, Private, Unlisted. |
| Notify Subscribers (YouTube) | Boolean whether to notify subscribers about the new YouTube video. |
| Options | Additional platform-specific options including: |
| - Linkedin Page | Post to a LinkedIn Company Page instead of personal profile by specifying page ID. |
| - Made for Kids (YouTube) | Boolean indicating if the YouTube video is made for kids. |
| - Media Type (Facebook) | Type of Facebook video post: Video or Reel. Ignored for text/image posts. |
| - Media Type (Instagram) | Type of Instagram video post: Reel or Story. Ignored for image-only posts. |
| - Pinterest Alt Text | Alternative text for accessibility on Pinterest pins. |
| - Pinterest Link | URL the Pinterest pin should link to. |
| - Reply Control (Threads) | Controls who can reply to Threads posts. Options: Everyone, Accounts You Follow, Mentioned Only. |
| - Scheduled Time | DateTime string to schedule the post for future publishing (e.g., "2024-12-31T23:59:59Z"). |
Output
The node outputs an array of JSON objects, each representing the response from the Blotato API after creating a post. The structure of the output JSON depends on the API response but generally includes details about the created post such as IDs, status, and metadata.
If binary data is involved (not applicable for this Post Create operation), it would be handled separately, but this operation primarily deals with JSON responses.
Dependencies
- Requires an API key credential for the Blotato API configured in n8n.
- The node uses the Blotato API endpoints
/v2/postsfor creating posts. - For resource locators (accounts, pages, boards), it relies on internal methods to fetch available accounts or subaccounts.
- Network access to the Blotato API server is required.
Troubleshooting
Error: Platform requires you to post an image or video.
Occurs if posting to Instagram, TikTok, Pinterest, or YouTube without providing any media URLs. Solution: Provide at least one valid media URL.Error: Thread Posts must be a valid JSON array.
When using the "From Data" thread input method, the provided JSON string must be correctly formatted. Validate JSON syntax and ensure each item has a "text" property.Invalid Account/Page/Board ID errors
Ensure IDs are numeric where required and match the expected format.Unsupported platform or resource errors
Verify that the selected platform supports the post creation operation.Scheduling issues
Scheduled time must be in ISO 8601 format with timezone info (e.g., ending with 'Z' or offset).
Links and References
- Blotato API Documentation (hypothetical, replace with actual if available)
- n8n Documentation on Creating Custom Nodes
- Social media platform developer docs for specifics on post types and restrictions (e.g., Instagram Graph API, YouTube Data API)