Skip to main content
Postsiva’s unified API and MCP cover eight publishing networks. Snapchat connects via unified OAuth. WhatsApp is an agent channel.

Unified publishing platforms

PlatformConnectTextImageCarouselVideoNotes
LinkedInOAuthPersonal profile + organization pages
FacebookOAuthFacebook Pages only (not personal profiles)
InstagramOAuthBusiness/Creator account required
TikTokOAuth (Business)TikTok Business account
YouTubeOAuthVideo uploads with title + description
ThreadsOAuth500-character text limit
PinterestOAuthRequires board_id for every pin
BlueskyHandle + app password300-character text limit

Other platforms

PlatformRoleDocs
SnapchatUnified OAuth + profilesConnect via /unified/oauth
WhatsAppWorkspace agent (Pro)Chat channel, not a publish target
Unified post/OAuth slugs (lowercase): linkedin, facebook, instagram, tiktok, youtube, threads, pinterest, bluesky, plus OAuth snapchat.

Connect accounts

OAuth platforms (all except Bluesky):
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", "facebook"]}'
Open each returned auth_url to complete OAuth. Check status:
curl "https://backend.postsiva.com/unified/oauth/token" \
  -H "X-API-Key: psk_live_YOUR_KEY"
Bluesky uses handle + app password instead of OAuth — see Bluesky.

Post to multiple platforms

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", "bluesky"],
    "default_text": "One caption, three platforms."
  }'
Each platform in platforms gets its own result object. Failures on one platform do not block others.

Platform-specific fields

Some platforms require extra fields beyond default_text:
PlatformRequired / common fields
LinkedInlinkedin.linkedin_page_ids, post_to_personal
Facebookfacebook.facebook_page_ids
Pinterestpinterest.board_id
YouTubeyoutube.youtube_title, youtube.youtube_description
TikToktiktok.privacy_level (optional, defaults to public)
See each platform page for full field reference and examples.

API key scopes

When using a scoped API key, only platforms listed in the key’s scope can be connected or posted to. A linkedin_only key cannot connect Instagram. See Authentication — API key scopes.

Character limits

Per-platform text and caption limits.

Media guidelines

Image and video requirements.

Scheduling

Schedule posts with scheduled_time.

Drafts

Save drafts and publish later.