Skip to main content
Follow these steps in order — all setup happens in the Postsiva app first, then you automate with the REST API or MCP.

​
1. Sign up or log in

Go to postsiva.com and sign up (email + OTP + password) or log in.

​
2. Create a workspace

Create a workspace or accept an invite. Pick the workspace you will use for API access (switcher in the app header). OAuth tokens, posts, drafts, and your API key are all scoped to this workspace.

​
3. Connect your accounts

Settings → Integrations → connect each network you need (LinkedIn, Instagram, Facebook, TikTok, YouTube, Threads, Pinterest, Bluesky, …).
  • Complete OAuth in the browser popup for each platform.
  • Facebook: select the Pages you want to manage.
  • LinkedIn: connect org pages if you post as a company.
  • Bluesky: use handle + app password (no OAuth popup).
You need Pro for API keys. Upgrade under Settings → Billing if API Keys is locked.
Alternatively, after you have an API key, connect via OAuth API: 
curl -X POST "https://backend.postsiva.com/unified/oauth/url" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{"platform":["linkedin","instagram"]}'
Open each returned auth_url to finish linking.

​
4. Create your API key

  1. Open Settings → API Keys.
  2. Click Create API Key — name it (e.g. production) and choose a scope (full for most integrations).
  3. Copy psk_live_… once — it is not shown again.
This key is how you call all REST endpoints (/unified/post/*, /unified/posts, /unified/analytics, …). Workspace is inferred from the key — no X-Workspace-Id required.
Store your key securely. Revoke and recreate if exposed.

​
5. Send your first REST post

curl -X POST "https://backend.postsiva.com/unified/post/text" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "platforms": ["linkedin", "threads"],
    "default_text": "Hello from the Postsiva API!"
  }'
​
results
array
Per-platform success/error objects with post metadata.

​
Schedule for later

Add scheduled_time (ISO 8601 UTC): 
{
  "platforms": ["linkedin"],
  "default_text": "Scheduled post",
  "scheduled_time": "2026-07-10T14:30:00Z"
}

​
Save as draft

{
  "platforms": ["linkedin"],
  "default_text": "Draft caption",
  "draft": true
}

​
6. Or connect Unified MCP

Same API key for AI agents (Cursor, Claude, etc.): 
# URL: https://mcp.postsiva.com/mcp
# Header: X-API-Key: psk_live_YOUR_KEY
See Connect to MCP.

​
7. Verify

  • Check the platform, or
  • GET https://backend.postsiva.com/unified/posts?platforms=linkedin&limit=5 with your API key

​
Next steps

Complete setup

Full UI + programmatic OAuth flow.

Authentication

Headers, scopes, and plan requirements.

API Overview

All REST endpoint groups.

Posting guide

Text, image, video, carousel, drafts, scheduling.