Package Information
Available Nodes
Documentation generating…
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.
- In Social Poster, open the account menu and go to AI access (KI-Zugriffe).
- 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. - Paste the key into the n8n credential. Set Base URL to the address of your Social Poster app without
/mcpat the end, for examplehttps://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.