Description
n8n-nodes-planvortex
An n8n community node for PlanVortex, verified by n8n. It lets an n8n
workflow publish to social networks, upload media, read and reply to comments, and hand a client a
link to connect their own accounts.
PlanVortex manages social networks from one API, among them Facebook, Instagram, Threads,
LinkedIn, TikTok, X, YouTube, Bluesky, Pinterest, Discord, Telegram and Slack. The ones worth
naming here are the last three: announcing a release on LinkedIn, dropping it in a customer
Discord and posting it to an internal Slack channel is normally three separate integrations.
n8n is a fair-code licensed
workflow automation platform.
Installation
n8n Cloud: this is a verified community node, so it installs from the nodes panel: search for
PlanVortex and install it. Only the instance owner or an admin can do that; nobody else on
the instance can.
Self-hosted n8n: go to Settings → Community Nodes, choose Install and enter
n8n-nodes-planvortex. The installation
guide covers the other ways,
including the command line.
Operations
| Resource | Operation | What it does |
| — | — | — |
| Publication | Create | Publishes now or schedules a post on one connected account, a Pinterest pin with its board and link included |
| Media | Upload | Puts an image or a video in the organization’s library, ready to attach |
| Account | Get Many | Lists the connected accounts, with a filter for what their network can do |
| Account | Create Connect Link | Mints a single-use link for a person to connect one of their own accounts |
| Comment | Get Many | Reads the comment and review inbox |
| Comment | Reply | Publishes a public reply to a comment or a review |
| Social Network | Get Capabilities | Says what every network supports, one item per network |
The organization and the account are dropdowns, filled from your own account: nothing here
asks you to paste an id. Both still accept an expression when the id comes from an earlier node.
Seven operations, not one hundred and thirty-five. Anything else the API does is one HTTP Request
node away, using the same credential — see the PlanVortex API
documentation.
Five things are worth knowing before you build on them:
- Connecting a social account cannot be automated. It is an OAuth flow with a person clicking
- An invalid post is not an error. PlanVortex stores it in state
withErrors, with the reasons - Not every network does everything. WhatsApp has no feed, and Slack and Pinterest publish
- On TikTok, a person chooses who sees the post. TikTok’s content sharing guidelines forbid
- On Pinterest, a pin goes to a board. Choosing the account does not choose where the pin
- Comments and replies need a paid plan. The rest of this node works on the free one.
- n8n community nodes documentation
- PlanVortex API documentation
“authorize” on the network’s own screen, and app credentials are refused outright. *Create
Connect Link* gives you a link that lasts fifteen minutes and connects one account; send your
user to it and watch the accounts listing for the result.
inside it, and answers 200 — so a workflow that only watches for exceptions would report a post
that never went out as sent. Create has a Fail on Publication Errors toggle, on by default,
that turns it into a real failure.
but have no comment inbox. Get Capabilities is how a workflow finds that out once instead of
one network at a time, in production. The account dropdown for publishing already hides the
accounts that cannot publish.
a default, so Create has a Visibility field and the boxes Allow Comments, **Allow
Duet, Allow Stitch, Promotes Own Brand and Branded Content** (all in Additional
Fields). Which visibilities an account allows depends on the account: a private one has
Followers instead of Public, and a value it does not allow fails with error 2505 listing the
ones it does. A paid partnership cannot be private (error 2504).
comes out, so Create has a Destination field (in Additional Fields) listing the account’s
boards, and a pin without one fails with error 987. The URL the pin leads to goes in Link,
not in the text. Every other network ignores both fields.
Credentials
You need a PlanVortex account and an app (API credentials), which you create in the PlanVortex
panel. An app gives you a clientid and a clientsecret; the node exchanges them for an access
token using the OAuth 2.0 client-credentials grant, and n8n caches that token for you.
Create a PlanVortex OAuth2 API credential in n8n and fill in three fields:
| Field | What goes in it |
| — | — |
| Base URL | https://api.planvortex.com/v1.0.0 — leave it alone unless you were given another environment |
| Client ID | the app’s client_id |
| Client Secret | the app’s client_secret |
There is no “Connect” button and there should not be one: the client-credentials grant has no
consent screen. Use Test instead — it performs the real token exchange and reads back the
clients and organizations the app can see.
Apps are available on all PlanVortex plans, including the free one.
Note that comments and comment replies require a paid plan. A workflow built on a free plan
will publish happily and fail on the comment steps.
Errors
PlanVortex answers a numbered error code, and the number is what says what happened — not the
HTTP status. Almost everything arrives as a 400: an expired token, a disconnected account, a text
that is too long and a plan that does not include the feature are all 400s, and only rate limits
(429) and permissions (401) differ.
So the node shows you two lines: the API’s own message, and underneath it what to do about that
particular code. They are different things for codes that sit next to each other — 516 means the
account is on the free plan, 519 means the call can never be made with app credentials, and 520
means the app is missing a permission and names which one. The code itself is in the second line,
which is what to quote if you ask support.
Turning on Continue On Fail is worth it for any workflow that touches several accounts: one
disconnected account then costs you that item instead of the whole run.
Compatibility
Requires Node.js 20 or newer. Built and unit-tested against n8n-workflow 2.x, the library n8n 2
runs on.
