Blotato Post PublishInstall

Overview

This node allows 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 sending data to a custom webhook URL. Users can create simple posts with text and media URLs, schedule posts for future publication, and for some platforms, create threaded posts with additional content.

Common scenarios include:

• Automating social media marketing by scheduling posts across multiple platforms.
• Publishing multimedia content with text and images/videos hosted on a specific domain.
• Creating threads or multi-part posts on platforms like Twitter, Bluesky, and Threads.
• Sending post data to custom webhooks for further processing or integration.

Practical examples:

• Scheduling a promotional tweet with images and follow-up tweets as a thread.
• Posting a video to YouTube with a specified title and privacy settings.
• Publishing a pin to a Pinterest board with a title, alt text, and link.
• Sending post data to a webhook URL for custom handling or logging.

Properties

Output

The node outputs an array of JSON objects, each corresponding to an input item processed. Each output object contains:

• success: Boolean indicating if the post submission was successful.
• postSubmissionId: A unique identifier for the submitted post returned by the API (present only if successful).
• platform: The platform to which the post was published.
• scheduledTime: The scheduled time for the post if it was scheduled; otherwise null.
• error: Error message string if the post failed to submit (present only if unsuccessful).

No binary data output is produced by this node.

Example output JSON:

{
  "success": true,
  "postSubmissionId": "abc123xyz",
  "platform": "twitter",
  "scheduledTime": null
}

Or on failure:

{
  "success": false,
  "error": "No twitter account ID provided in node parameters or credentials. Please add it to your API credentials or provide it directly in the node."
}

Dependencies

• Requires an API key credential for the Blotato API service to authenticate requests.
• The media URLs included in posts must be hosted on the blotato.com domain.
• For posting to certain platforms, specific account or page IDs may be required either in the node parameters or stored in credentials.
• No other external dependencies are needed.
• The node makes HTTP POST requests to the Blotato API endpoint /posts to 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 from blotato.com domain. Using URLs from other domains will likely cause failures.
• Scheduling Issues: When scheduling posts, the scheduled time must be provided and valid.
• Unsupported Platforms: Some properties are only applicable to specific platforms; setting them incorrectly may cause errors.
• API Errors: Network issues or invalid API keys will cause request failures. Verify API credentials and network connectivity.
• Thread Creation: For platforms supporting threads, ensure additional posts have valid text content.

Common error messages:

• "No [platform] account ID provided...": Provide the missing account ID.
• "Facebook Page ID is required...": Provide the Facebook Page ID.
• Other API error messages will be passed through; check API documentation for details.

Links and References

• Blotato API Documentation (hypothetical)
• Social media platform developer docs for account/page IDs and posting requirements.
• n8n documentation on creating and using credentials and scheduling nodes.