Skip to main content
Automate Postsiva with the official n8n-nodes-postsiva 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

ApproachBest for
Community nodes (recommended)Visual workflows — post, schedule, inbox, AI, watcher
HTTP RequestCustom endpoints, one-off experiments
MCP AI AgentNatural-language tool selection in AI workflows

​
Install community nodes

​
n8n Cloud or self-hosted UI

  1. Open Settings → Community nodes → Install
  2. Enter package name: n8n-nodes-postsiva
  3. 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 · Source: postsiva/n8n-nodes-postsiva on GitHub

​
Credentials

Create a Postsiva API credential once and reuse across all Postsiva nodes.
FieldRequiredValue
API KeyYespsk_live_… from workspace Settings → API Keys
Base URLNohttps://backend.postsiva.com (default)
Workspace IDAI nodes onlyWorkspace 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.
NodeNotes
Post to LinkedIn (Personal)Visibility: Public / Connections
Post to LinkedIn PagePage picker (from user profile)
Post to Facebook PagePage picker (required)
Post to InstagramText, image, carousel
Post to ThreadsCaption max 500 chars
Post to TikTokTitle, privacy level
Post to YouTubeVideo only — title required
Post to PinterestBoard picker (required)
Post to BlueskyCaption max 300 chars; carousel max 4 images
Shared posting fields: Caption, media source (URL · Postsiva media ID · binary), schedule, save as draft.
Post typeAPI path (under the hood)
TextPOST /unified/post/text
ImagePOST /unified/post/image
VideoPOST /unified/post/video
CarouselPOST /unified/post/carousel
Page and board dropdowns load from Get User Profile (GET /unified/user-profiles/).

​
Account (4)

NodeDescription
Get User ProfileProfiles, LinkedIn orgs, FB pages, Pinterest boards
Get Connection StatusWhich platforms are connected
Connect AccountOAuth URL (open in browser) or Bluesky handle + app password
Disconnect AccountRemove a platform connection

​
Media (3)

NodeDescription
Upload MediaBinary file or public URL → returns media_id
List Media LibraryPaginated library list
Delete MediaRemove by media_id

​
Scheduled queue (4)

NodeDescription
Get Scheduled PostsFilter by status, platform
Create Scheduled PostSchedule-only create (scheduled_time required)
Publish Scheduled Post NowPublish queue item immediately
Cancel Scheduled PostDelete / cancel scheduled item

​
Drafts (3)

NodeDescription
Get DraftsList workspace drafts
Publish DraftPublish draft now
Schedule DraftMove draft to schedule queue

​
Content (2)

NodeDescription
Get PostsPublished posts across platforms
Get Single PostOne post by ID + platform

​
Inbox & analytics (5)

NodeDescription
Get CommentsInbox view — recent posts per platform
Get Comments by PostComments for one post_id
Get Comment RepliesThread replies for a comment_id
Reply to CommentPost a reply
Get InsightsAnalytics / insights
Requires Inbox plan feature for comment nodes.

​
AI generation (4) — does not publish

Set Workspace ID in the credential. Consumes AI credits.
NodeDescription
AI Generate Post from IdeaIdea → platform-specific copy
AI Generate ImageCaption → images
AI Image to PostImage URL → post copy
AI Video to PostVideo URL → post copy
Chain output into a Post to … node when ready to publish. See AI Content API.

​
AI Watcher (7)

NodeDescription
Enable AI WatcherWatch comments on a post
Disable AI WatcherStop watching
Get Enabled AI WatchersList watched posts
Update AI Watcher RulesLead keywords + custom rule
Get LeadsDetected leads
Get AI Watcher HistoryRun history
Force Run AI WatcherRun all enabled or one post
See AI Watcher API.

​
Brand persona (2)

NodeDescription
Get Brand PersonaRead workspace persona
Update Brand PersonaTone, 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

SettingValue
AuthenticationHeader Auth
Header nameX-API-Key
Header valuepsk_live_YOUR_KEY
Set Content-Type: application/json on POST/PATCH nodes.

​
Base URL

https://backend.postsiva.com

​
Quick reference

TaskMethodPath
OAuth URLPOST/unified/oauth/url
Connection statusGET/unified/oauth/token
Post textPOST/unified/post/text
Post imagePOST/unified/post/image
Upload mediaPOST/media/upload
List postsGET/unified/posts
Scheduled queueGET/unified/scheduled-posts
DraftsGET/unified/drafts
AnalyticsGET/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:
FieldValue
URLhttps://mcp.postsiva.com/mcp
HeaderX-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 codeAction
401Rotate or fix API key
403Check plan, key scope, or feature flag
422Validation — caption length, missing page ID, etc.
402Upgrade 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