Overview
This node allows users to create social media posts on various platforms through the Blotato API. It supports posting text, media (images/videos), and threads (multi-part posts) across multiple social networks including Instagram, Facebook, Twitter, TikTok, LinkedIn, Pinterest, Bluesky, Threads, and YouTube.
Typical use cases include:
- Automating content publishing workflows for marketing or social media management.
- Scheduling posts with rich media attachments.
- Creating threaded posts on platforms that support multi-part content (e.g., Twitter threads).
- Customizing platform-specific post options such as privacy settings on TikTok or video titles on YouTube.
For example, a user can create an Instagram reel with a caption and multiple images, or schedule a YouTube video upload with specific privacy settings and subscriber notifications.
Properties
| Name | Meaning |
|---|---|
| Platform | The social media platform where the post will be published. Options: Bluesky, Facebook, Instagram, Linkedin, Pinterest, Threads, Tiktok, Twitter, Youtube. |
| Account | The user's social media account ID on Blotato for the chosen platform. |
| Text | The main textual content of the post. |
| Media URLs | Comma-separated list of publicly accessible URLs pointing to media files (images/videos) to attach to the post. |
| Thread (Optional) | For Twitter, Threads, and Bluesky: method to create a long-form thread. Options: Manual (add each post manually), From Data (use array data from previous node). |
| Thread Posts (Manual) | When using manual thread input, a collection of additional posts in the thread, each with text and optional media URLs. |
| Thread Posts (From Data) | When using array input for thread posts, a JSON array string where each item has "text" and optionally "mediaUrls" (array of strings). |
| Privacy Level (TikTok only) | Privacy setting for TikTok posts. Options: Self Only, Public to Everyone, Mutual Follow Friends, Follower of Creator. |
| Slideshow Title (TikTok) | Title for TikTok slideshows (max 90 characters). Defaults to first 90 characters of the main text if not set. |
| Post As Draft (TikTok) | Whether to post the TikTok video/slideshow as a draft, requiring finalization in the TikTok app. |
| Disable Comments (TikTok) | Whether to disable comments on the TikTok post (hidden if posting as draft). |
| Disable Duet (TikTok) | Whether to disable duet feature on the TikTok post (hidden if posting as draft). |
| Disable Stitch (TikTok) | Whether to disable stitch feature on the TikTok post (hidden if posting as draft). |
| Is Branded Content (TikTok) | Whether the TikTok post contains branded content (hidden if posting as draft). |
| Is Your Brand (TikTok) | Whether the TikTok post is about your own brand (hidden if posting as draft). |
| Is AI Generated (TikTok) | Whether the TikTok content is AI generated (hidden if posting as draft). |
| Auto Add Music (TikTok) | Automatically add music to TikTok slideshow (only works for slideshows, hidden if posting as draft). |
| Facebook Page | Facebook Page ID to post to (required for Facebook platform). |
| Pinterest Board | Pinterest Board ID to pin to (required for Pinterest platform). Pinterest requires 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) | Whether to notify subscribers about the new YouTube video. |
| Made for Kids (YouTube) | Whether the YouTube video is made for kids. |
| Contains Synthetic Media (YouTube) | Whether the YouTube media contains synthetic content like AI-generated images or videos. |
| Options | Additional platform-specific options: - Image Cover Index (TikTok slideshows): index of image to use as thumbnail cover. - Linkedin Page ID: post to company page instead of personal profile. - Facebook Media Type: video or reel. - Instagram Media Type: reel or story. - Pinterest Alt Text: accessibility text. - Pinterest Link: URL the pin should link to. - Threads Reply Control: who can reply to Threads posts. - Scheduled Time: schedule post for future time. - Video Cover Timestamp (TikTok): millisecond timestamp for video thumbnail frame. |
Output
The node outputs the JSON response returned by the Blotato API for the created post. This includes details such as post IDs, status, URLs, and any metadata returned by the platform's API.
If the operation fails, the output contains error information with messages and details.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for the Blotato API configured in n8n.
- The node makes authenticated HTTP requests to the Blotato API endpoints.
- Some features require valid account IDs and subaccount/page/board IDs depending on the platform.
- Media URLs must be publicly accessible for attachment.
- For binary media uploads, external hosting services are recommended due to size limits.
Troubleshooting
- Missing Required Fields: Errors occur if required fields like account ID, platform, or media URLs (for certain platforms) are missing.
- Invalid Account or Page IDs: Ensure IDs conform to expected formats (numeric or string as specified).
- Media Requirements: Platforms like Instagram, TikTok, Pinterest, and YouTube require at least one image or video URL; otherwise, an error is thrown.
- Thread Posts Format: When using array input for threads, ensure valid JSON format with correct properties ("text" and optional "mediaUrls").
- File Size Limits: Binary uploads are limited to 15MB; larger files should be uploaded via URL.
- API Errors: If the Blotato API returns errors, check the API Dashboard link provided in the node hints for debugging.
- Scheduling Time Format: Scheduled time must be in ISO 8601 format with timezone (e.g., ending with 'Z' or offset).