social-poster

n8n community node for Social Poster: list accounts, create drafts and schedule social media posts with a team API key.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: Social Poster

Documentation

n8n-nodes-social-poster

n8n community node for Social Poster. It lists the social accounts of a team, creates drafts and schedules posts from n8n workflows and from the n8n AI Agent.

You need a Social Poster account. Register at https://app.social-poster.io. Without an account and an API key, the node cannot do anything.

n8n is a fair-code licensed workflow automation platform. This package is licensed under the MIT License.

Installation

This node is for self-hosted n8n (server, Docker or npm). It is not listed for n8n Cloud yet.

Follow the installation guide in the n8n community nodes documentation. In n8n, open Settings → Community Nodes, choose Install and enter n8n-nodes-social-poster.

Credentials

Create a Social Poster API credential in n8n.

  1. In Social Poster, open the account menu and go to AI access (KI-Zugriffe).
  2. Open the card API key for n8n (API-Schlüssel für n8n), choose Create key and copy the key. It starts with spk_ and is shown only once.
  3. Paste the key into the n8n credential. Set Base URL to the address of your Social Poster app without /mcp at the end, for example https://app.social-poster.io.

One key belongs to one team. Creating a new key replaces the old one. You can revoke the key in the same card. The key works only when Social Poster has enabled API keys for that team, the plan includes AI access, and the account switches in AI access allow the account.

Operations

Resource Operation What it does
Account Get Many Lists the connected accounts you can post to
Draft Create Creates a draft without scheduling it
Draft Get Returns a draft and its status
Draft Update Changes text, link, media or other fields of a draft
Draft Validate Checks a draft against the rules of its network
Draft Discard Discards a draft
Draft Schedule Stores a time on a draft without confirming it for publishing
Draft Cancel Schedule Removes the time from a draft
Post Create and Schedule Creates a draft, schedules it and confirms it for publishing in one step
Post Schedule Draft Schedules an existing draft and confirms it for publishing
Workspace Get Many Lists the workspace (team) of the key
Workspace Get AI Context Returns brand profile and network rules, useful for writing posts with AI
Help Search Searches the Social Poster help center

Media are passed as public http(s) URLs (up to 20 per post). Uploading files is not supported yet.

Rules and limits

  • No immediate publishing. With an API key, a post must be scheduled at least 5 minutes in the future. If you want a post to go out quickly, use Schedule → In Minutes with 5 minutes.
  • Same rules as the Social Poster assistant. Account switches, approval by a person, responsibility notices for some networks and plan limits apply. If a team requires approval, a scheduled post waits in Social Poster under "Waiting for you" until someone approves it.
  • X (Twitter) requires that a person reviewed the exact text and media. Turn on X Content Reviewed only if that is true.
  • Rate limits: 30 requests per minute per key, 10 per minute for draft changes and 3 per minute for publishing steps.
  • Errors from Social Poster come with a short English explanation and the original code.

The node can be attached to the n8n AI Agent as a tool. The rules above apply in the same way.

Compatibility

Built with the n8n node CLI and tested with n8n 2.x (self-hosted). Requires a Social Poster server with team API keys enabled.

Resources

Discussion