Integration options
| Method | Best for | Auth |
|---|---|---|
| REST API | Custom apps, scripts, backends | X-API-Key: psk_live_… |
| cURL recipes | Quick tests, CI, shell scripts | Same API key header |
| n8n | Visual workflows, webhooks, cron | Community nodes (n8n-nodes-postsiva) or HTTP Request |
| Zapier | No-code automations | Webhooks + Code steps |
| Make.com | Scenarios with HTTP modules | API key header |
| Unified MCP | AI agents (Cursor, Claude) | API key header or query param |
| Claude Desktop | Conversational MCP | Same MCP URL + API key |
| GPT Actions | ChatGPT Custom GPT | Bearer API key |
| Chrome extension | LinkedIn repost UI | App login (Starter+) |
| WhatsApp agent | Chat control on mobile | Pro WhatsApp link |
Base URL
http://localhost:8000
Authentication
All integrations use the same workspace API key:Authorization: Bearer psk_live_YOUR_KEY
API keys require the Pro plan (
api_keys_enabled). MCP requires Pro with mcp_enabled.Common workflows
| Workflow | Endpoints |
|---|---|
| Connect account | POST /unified/oauth/url |
| Upload media | POST /media/upload |
| Publish post | POST /unified/post/text | /image | /video |
| Schedule post | Add scheduled_time or POST /unified/scheduled-posts |
| Save draft | draft: true or POST /unified/drafts |
| List posts | GET /unified/posts |
| List queue | GET /unified/scheduled-posts, GET /unified/drafts |
| Analytics | GET /unified/analytics |
| Reply to comment | POST /unified/comments/reply |
Idempotency and errors
- Multi-platform posts return per-platform results — partial success is normal
- Check
errorfield in response items (NOT_CONNECTED, validation errors) - HTTP status reflects request-level issues; platform errors are in the body
Rate limits
API keys may hit rate limits under heavy use. Response includes rate limit details when exceeded.Choose your integration
n8n
Official community nodes (43) — posting, schedule, inbox, AI, watcher.
Zapier
Webhooks + Code steps pattern for no-code automations.
Make.com
HTTP modules + scenarios against the same REST API.
cURL
Copy-paste recipes for common operations.
Claude Desktop
Unified MCP inside Claude.
Chrome extension
LinkedIn side-panel repost + AI.
Workspace agent over WhatsApp (Pro).
MCP
Connect Cursor and other MCP clients.
Webhooks (incoming)
Postsiva does not push outbound webhooks for post status today. PollGET /unified/scheduled-posts or GET /unified/posts from your automation on a schedule, or use n8n/Zapier timers.
Facebook and Instagram comment webhooks are handled server-side for inbox features — not user-configurable outbound hooks.