n8n-nodes-viraly

An n8n community node for Viraly — the social media management platform that schedules, publishes, and analyses posts across 10 platforms (Facebook, Instagram, Twitter/X, LinkedIn, TikTok, Pinterest, YouTube, Threads, Bluesky, Mastodon).

Features

Trigger: Viraly Trigger

Polls Viraly and starts a workflow when any of the following happens:

• New Post Published — a post is successfully published to a social platform
• New Post Scheduled — a post is scheduled for publishing
• Post Failed — a post fails to publish
• New Channel — a new social channel is connected to the workspace
• New Bio Link Subscriber — someone submits the email capture form on a bio link page

Action: Viraly

Acts on Viraly data inside a workflow:

• Post: Create, Update, Get, Publish, Delete, List
• Channel: Get, List
• Social Set: List
• Subscriber: List

The node handles the 10-platform-specific PostConfig server-side — you only supply caption, channelId, and schedule info. The Viraly API builds the right Facebook/Instagram/Twitter/... config for you.

Install (self-hosted n8n)

1. Open your n8n instance.
2. Go to Settings → Community Nodes.
3. Click Install.
4. Paste n8n-nodes-viraly into the npm Package Name field.
5. Accept the risks (community nodes run arbitrary code) and click Install.
6. Restart your n8n instance if it doesn't reload automatically.
7. Search for "Viraly" in the node picker to confirm it's installed.

Install (n8n Cloud)

If this package is listed as a Verified Community Node on n8n Cloud, it appears in the node picker for all Cloud users automatically — no install step needed.

If it is not yet verified, n8n Cloud does not permit installation.

Configure credentials

The node uses Viraly's OAuth 2.0 with PKCE. Configure once per n8n install:

1. In n8n, go to Credentials → New.
2. Search for Viraly OAuth2 API and click it.
3. Leave the grant type and URLs at their defaults.
4. Enter your Client ID and Client Secret (from the Viraly support team).
5. Click Connect my account → you'll be redirected to Viraly.
6. Log in, pick a workspace, and click Allow Access.
7. You're redirected back to n8n with the credential saved.

The scopes requested:

posts:read posts:write channels:read analytics:read
biolinks:read subscribers:read workspace:read social_sets:read media:write

Usage examples

Example 1 — Auto-schedule a post when an RSS item publishes

RSS Feed Trigger  →  Viraly (action: post.create, Schedule for Later)

Example 2 — Get a Slack alert when a post fails

Viraly Trigger (event: Post Failed)  →  Slack (send channel message)

Example 3 — Capture new bio link subscribers to a spreadsheet

Viraly Trigger (event: New Bio Link Subscriber)  →  Google Sheets (append row)

Development

git clone https://github.com/viraly-io/n8n-nodes-viraly.git
cd n8n-nodes-viraly

npm install
npm run build    # compile TS → dist/
npm run lint     # run n8n-nodes-base eslint preset

Test locally against your n8n install

# in this package
npm link

# in your n8n install root
npm link n8n-nodes-viraly

Then restart n8n. The Viraly nodes will appear without publishing to npm.

Publish

npm run prepublishOnly
npm publish --access public

Supported platforms

Facebook, Instagram, Twitter / X, LinkedIn, TikTok, Pinterest, YouTube, Threads, Bluesky, Mastodon.

License

MIT — see LICENSE.

Support

• Docs: https://viraly.io/docs/n8n-integration
• Issues: https://github.com/viraly-io/n8n-nodes-viraly/issues
• Contact: [email protected]