n8n Integration - Postsiva

Automate Postsiva with the official n8n-nodes-postsiva-official community package — no manual HTTP wiring for standard workflows.

Requires Pro plan with api_keys_enabled. AI generation nodes also need Workspace ID in the credential.

Three ways to integrate

Approach	Best for
Community nodes (recommended)	Visual workflows — post, schedule, inbox, AI, watcher
HTTP Request	Custom endpoints, one-off experiments
MCP AI Agent	Natural-language tool selection in AI workflows

Install community nodes

n8n Cloud or self-hosted UI

Open Settings → Community nodes → Install
Enter package name: n8n-nodes-postsiva-official
Confirm install and restart n8n if prompted

Verify install

Search the node palette for Postsiva. You should see 43 nodes grouped by area (Posting, Account, Media, etc.).

Package: npm n8n-nodes-postsiva-official · Source: postsiva/n8n-nodes-postsiva on GitHub

Credentials

Create a Postsiva API credential once and reuse across all Postsiva nodes.

Field	Required	Value
API Key	Yes	`psk_live_…` from workspace Settings → API Keys
Base URL	No	`https://backend.postsiva.com` (default)
Workspace ID	AI nodes only	Workspace UUID — used as `workspace_id` on AI generate endpoints

Never embed API keys in workflow JSON you share publicly. Use n8n’s credential store.

Test the credential — it calls GET /unified/oauth/token to verify the key.

Node catalog (43)

Posting (9)

Per-platform nodes with Post Type selector (text · image · video · carousel). Unsupported types are hidden per platform.

Node	Notes
Post to LinkedIn (Personal)	Visibility: Public / Connections
Post to LinkedIn Page	Page picker (from user profile)
Post to Facebook Page	Page picker (required)
Post to Instagram	Text, image, carousel
Post to Threads	Caption max 500 chars
Post to TikTok	Title, privacy level
Post to YouTube	Video only — title required
Post to Pinterest	Board picker (required)
Post to Bluesky	Caption max 300 chars; carousel max 4 images

Shared posting fields: Caption, media source (URL · Postsiva media ID · binary), schedule, save as draft.

Post type	API path (under the hood)
Text	`POST /unified/post/text`
Image	`POST /unified/post/image`
Video	`POST /unified/post/video`
Carousel	`POST /unified/post/carousel`

Page and board dropdowns load from Get User Profile (GET /unified/user-profiles/).

Account (4)

Node	Description
Get User Profile	Profiles, LinkedIn orgs, FB pages, Pinterest boards
Get Connection Status	Which platforms are connected
Connect Account	OAuth URL (open in browser) or Bluesky handle + app password
Disconnect Account	Remove a platform connection

Media (3)

Node	Description
Upload Media	Binary file or public URL → returns `media_id`
List Media Library	Paginated library list
Delete Media	Remove by `media_id`

Scheduled queue (4)

Node	Description
Get Scheduled Posts	Filter by status, platform
Create Scheduled Post	Schedule-only create (`scheduled_time` required)
Publish Scheduled Post Now	Publish queue item immediately
Cancel Scheduled Post	Delete / cancel scheduled item

Drafts (3)

Node	Description
Get Drafts	List workspace drafts
Publish Draft	Publish draft now
Schedule Draft	Move draft to schedule queue

Content (2)

Node	Description
Get Posts	Published posts across platforms
Get Single Post	One post by ID + platform

Inbox & analytics (5)

Node	Description
Get Comments	Inbox view — recent posts per platform
Get Comments by Post	Comments for one `post_id`
Get Comment Replies	Thread replies for a `comment_id`
Reply to Comment	Post a reply
Get Insights	Analytics / insights

Requires Inbox plan feature for comment nodes.

AI generation (4) — does not publish

Set Workspace ID in the credential. Consumes AI credits.

Node	Description
AI Generate Post from Idea	Idea → platform-specific copy
AI Generate Image	Caption → images
AI Image to Post	Image URL → post copy
AI Video to Post	Video URL → post copy

Chain output into a Post to … node when ready to publish. See AI Content API.

AI Watcher (7)

Node	Description
Enable AI Watcher	Watch comments on a post
Disable AI Watcher	Stop watching
Get Enabled AI Watchers	List watched posts
Update AI Watcher Rules	Lead keywords + custom rule
Get Leads	Detected leads
Get AI Watcher History	Run history
Force Run AI Watcher	Run all enabled or one post

See AI Watcher API.

Brand persona (2)

Node	Description
Get Brand Persona	Read workspace persona
Update Brand Persona	Tone, audience, avoid list

Example workflows (community nodes)

Workflow 1: RSS → LinkedIn post

Schedule Trigger (daily)
  → RSS Read
  → Function (format caption, truncate to 3000)
  → Post to LinkedIn (Personal)  [postType: text]

Workflow 2: Google Sheet → scheduled posts

Google Sheets Trigger (new row)
  → Set (map: text, scheduled_time, platform)
  → Create Scheduled Post

Map columns to node fields: Caption, Scheduled Time, Platform, Post Type.

Workflow 3: Upload image then post to Instagram

HTTP Request / Webhook (binary image)
  → Upload Media  [mediaType: image, source: binary]
  → Post to Instagram  [postType: image, mediaSource: mediaId, mediaId: {{ $json.media_id }}]

Workflow 4: AI idea → draft → review → publish

Manual Trigger
  → AI Generate Post from Idea  [platforms: linkedin]
  → Post to LinkedIn (Personal)  [draft: true, caption: {{ $json.linkedin_text }}]
  → (human review in Postsiva app)
  → Publish Draft  [draftId: …]

Workflow 5: Poll failed scheduled posts

Schedule Trigger (every 15 min)
  → Get Scheduled Posts  [status: failed, limit: 10]
  → IF (items.length > 0)
  → Send Email / Slack alert

Workflow 6: Connect Bluesky

Manual Trigger
  → Connect Account  [platforms: bluesky, handle, appPassword]

Store Bluesky app password in n8n credentials — not in plain workflow fields.

Workflow 7: Enable AI Watcher on new LinkedIn post

Post to LinkedIn (Personal)
  → Enable AI Watcher  [postId: {{ $json.post_id }}, platform: linkedin]
  → Update AI Watcher Rules  [leadKeywords: pricing, demo, buy]

HTTP Request fallback

Use raw HTTP Request nodes when you need endpoints not covered by a community node, or for debugging.

Authentication

Setting	Value
Authentication	Header Auth
Header name	`X-API-Key`
Header value	`psk_live_YOUR_KEY`

Set Content-Type: application/json on POST/PATCH nodes.

Base URL

https://backend.postsiva.com

Quick reference

Task	Method	Path
OAuth URL	POST	`/unified/oauth/url`
Connection status	GET	`/unified/oauth/token`
Post text	POST	`/unified/post/text`
Post image	POST	`/unified/post/image`
Upload media	POST	`/media/upload`
List posts	GET	`/unified/posts`
Scheduled queue	GET	`/unified/scheduled-posts`
Drafts	GET	`/unified/drafts`
Analytics	GET	`/unified/analytics`

Full API reference: REST overview. Copy-paste examples: cURL recipes.

MCP alternative

For AI-driven workflows where the agent picks tools dynamically, connect Postsiva MCP:

Field	Value
URL	`https://mcp.postsiva.com/mcp`
Header	`X-API-Key: psk_live_YOUR_KEY`

See Postsiva MCP in n8n and Connect to MCP.

Agent Chat (POST /workspace-agent/website/chat) is not included in community nodes — use the web app, WhatsApp agent, or MCP for conversational flows.

Error handling

All Postsiva nodes support Continue On Fail. Add an Error Trigger workflow for global alerts.

HTTP code	Action
401	Rotate or fix API key
403	Check plan, key scope, or feature flag
422	Validation — caption length, missing page ID, etc.
402	Upgrade plan

See HTTP errors and Postsiva errors.

Integrations overview

All integration options

REST API

Full endpoint reference

MCP in n8n

AI Agent + MCP setup

cURL recipes

Copy-paste HTTP examples

​Three ways to integrate

​Install community nodes

​n8n Cloud or self-hosted UI

​Verify install

​Credentials

​Node catalog (43)

​Posting (9)

​Account (4)

​Media (3)

​Scheduled queue (4)

​Drafts (3)

​Content (2)

​Inbox & analytics (5)

​AI generation (4) — does not publish

​AI Watcher (7)

​Brand persona (2)

​Example workflows (community nodes)

​Workflow 1: RSS → LinkedIn post

​Workflow 2: Google Sheet → scheduled posts

​Workflow 3: Upload image then post to Instagram

​Workflow 4: AI idea → draft → review → publish

​Workflow 5: Poll failed scheduled posts

​Workflow 6: Connect Bluesky

​Workflow 7: Enable AI Watcher on new LinkedIn post

​HTTP Request fallback

​Authentication

​Base URL

​Quick reference

​MCP alternative

​Error handling

​Related

Integrations overview

REST API

MCP in n8n

cURL recipes

Three ways to integrate

Install community nodes

n8n Cloud or self-hosted UI

Verify install

Credentials

Node catalog (43)

Posting (9)

Account (4)

Media (3)

Scheduled queue (4)

Drafts (3)

Content (2)

Inbox & analytics (5)

AI generation (4) — does not publish

AI Watcher (7)

Brand persona (2)

Example workflows (community nodes)

Workflow 1: RSS → LinkedIn post

Workflow 2: Google Sheet → scheduled posts

Workflow 3: Upload image then post to Instagram

Workflow 4: AI idea → draft → review → publish

Workflow 5: Poll failed scheduled posts

Workflow 6: Connect Bluesky

Workflow 7: Enable AI Watcher on new LinkedIn post

HTTP Request fallback

Authentication

Base URL

Quick reference

MCP alternative

Error handling

Related