@socialrobot-io/n8n-nodes-socialrobot

This is an n8n community node. It lets you use SocialRobot.io in your n8n workflows.

SocialRobot is a social media scheduler that lets you queue a week of posts in one sitting and publish across Instagram, X (Twitter), LinkedIn, TikTok, Facebook, Pinterest, Bluesky, Mastodon, and Threads. This package exposes the SocialRobot Scheduler API so you can build scheduling and publishing directly into your automations.

n8n is a fair-code licensed workflow automation platform.

Installation Nodes Credentials Compatibility Usage Resources Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

In short:

1. In n8n, go to Settings → Community Nodes.
2. Select Install.
3. Enter @socialrobot-io/n8n-nodes-socialrobot in the npm package name field.
4. Select Install.

Nodes

The package ships one node, SocialRobot. Pick a Resource to choose what it does:

• A platform resource (Instagram, X (Twitter), LinkedIn, TikTok, Facebook, Pinterest, Bluesky, Mastodon, Threads) publishes a post to that platform.
• Post and Account manage posts and connected accounts.

Because each platform is its own Resource, the node only shows the fields that platform actually supports, and the account picker only lists accounts on that platform.

Publish (one Resource per platform)

Each platform resource has a single Create operation that publishes one post for a connected account on that platform. Every platform shares the same shape: an Account picker, a Caption, platform-specific media fields, and Schedule Type (Draft, Publish Now, or Schedule) with an optional Schedule Date.

| Resource | Media model | | --- | --- | | Instagram | Single image or video (required) | | Instagram (options) | Toggle Post as Reel for videos and AI-Generated Content for AI media | | X (Twitter) | Multiple media, up to 4; GIF supported | | LinkedIn | Image or video post (required) | | TikTok | Photo or video post (required); see TikTok options below | | Facebook | Optional media; toggle Post as Reel (validates exactly one video) | | Pinterest | Image or video pin (required), plus a Board ID | | Bluesky | Text only | | Mastodon | Optional images/videos | | Threads | Optional media |

Media is attached either as a public URL or as binary data from the input item (uploaded to SocialRobot storage automatically).

Post and Account (management)

• Post → Get — Fetch a single post by ID.
• Post → Get Many — List posts with optional filters (status, platform, scheduled date range) and cursor pagination, including a Return All option.
• Post → Delete — Delete a post by ID.
• Post → Reschedule — Change the scheduled publish time of a post.
• Account → Get Many — List all connected social accounts. Useful to discover account IDs (or just use the account picker, which loads them automatically).

Credentials

The node authenticates with a SocialRobot API key.

Prerequisites

1. Sign up for SocialRobot.
2. Open the app and go to Scheduler → API Keys.
3. Create an API key and copy it.

Setting up the credential

1. In n8n, go to Credentials → Add Credential and search for SocialRobot API.
2. Enter the API Key you created in SocialRobot.
3. Leave Base URL at the default (https://socialrobot.io/api) for the hosted service. If you are running SocialRobot locally or on a self-hosted instance, point it at your own API base URL (for example http://localhost:3000/api).

Use the Test button to verify the credential. It calls GET /accounts and should succeed if the key is valid.

Note: publishing a post requires at least one connected social account in SocialRobot. Connect accounts under Accounts in the app before creating posts.

Compatibility

• Requires n8n version 1.0.0 or later.
• Developed and tested against n8n-workflow version 1.x.

Usage

Publish a scheduled post to X

1. Add a SocialRobot node.
2. Set Resource to X (Twitter).
3. Pick your X account from the Account dropdown.
4. Type the post text in Caption.
5. Set Schedule Type to Schedule and choose a Schedule Date.

The node returns the created post ID ({ "id": "..." }).

Post media from binary data

1. Add an HTTP Request node that downloads an image, with Response Format set to File. This saves the response as binary data under the data property.
2. Add a SocialRobot node, set Resource to Instagram, and pick your Instagram account.
3. Set Media Source to From Binary Data and leave Binary Property as data.

The node uploads the binary file to SocialRobot storage automatically and uses the resulting URL in the post. To reference a public media URL instead, leave Media Source set to By URL and paste the URL into Media URL.

For platforms with a Media collection (X, Threads, Facebook, TikTok, LinkedIn, Pinterest, Mastodon), click Add Media to attach one or more entries; each entry has its own Media Source, Media Type, and URL or binary property. For the Pinterest resource, also set the Pinterest Board ID.

Filter scheduled posts

Add a SocialRobot node, set Resource to Post and Operation to Get Many, then add a Filters entry with Status = Scheduled to list everything waiting to publish.

TikTok options (3.1.0)

For TikTok, the node now includes:

• Post Mode: Direct Post or Send to Inbox (Draft) (default draft)
• Privacy Level (Direct Post only): Followers, Friends, Private, Public
• Interaction controls (Direct Post only): Disable Comments, Disable Duet, Disable Stitch
• AI-Generated Content label (Direct Post video only)
• Title (photo/slideshow posts, up to 90 characters)

Inbox uploads are finished in the TikTok app, so privacy and interaction settings only apply to Direct Post.

Instagram options (3.1.1)

For an Instagram image or video post:

• Post as Reel (videos): publishes the video as a Reel instead of a feed video.
• AI-Generated Content: labels the post as AI-generated in Instagram. Turn this on for any media produced by an AI model.

Both toggles map to the SocialRobot API (isReel and isAiGenerated); the AI label is sent to Instagram as is_ai_generated.

Resources

• n8n community nodes documentation
• SocialRobot
• SocialRobot API documentation
• Workflow templates — 36 ready-to-import workflows

Version history

3.1.1

Added an AI-Generated Content toggle to the Instagram resource. It maps to the API isAiGenerated field, which Instagram receives as is_ai_generated, so AI-made image and video posts carry the platform's AI label. No other behavior changes.

3.0.0

Consolidated the package into a single SocialRobot node (n8n allows one regular node per package). Each platform is now a Resource with its own Create operation, platform-scoped fields, and platform-scoped account picker. The per-platform request shapes from 2.0.0 are unchanged.

3.1.0

TikTok post options and Instagram/Facebook Reel flags. Also improves error messages from the API.

2.0.0

Split the single node into nine per-platform Publish to ... nodes plus a management-only SocialRobot node. Superseded by 3.0.0 after n8n review (one node per service).

1.0.5

Added binary media upload in Create Post (Media Source: By URL or From Binary Data) and removed the standalone Media resource.

1.0.0

Initial release with Post (Create, Get, Get Many, Delete, Reschedule) and Account (Get Many) operations.