> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postsiva.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Postsiva Developer Docs

> Unified social media API and MCP for posting, analytics, comments, and AI content across LinkedIn, Instagram, Facebook, TikTok, YouTube, Threads, Pinterest, and Bluesky.

Postsiva is a unified API and MCP server for social media — connect accounts once in a **workspace**, then publish, schedule, read analytics, manage inbox, and run AI workflows with a **workspace API key** (`psk_live_…`) or **Unified MCP** (Cursor, Claude, ChatGPT).

Product map (publishing, AI Watcher, personas, agents, clients): [Features overview](/features/overview).

## Supported platforms

Unified publishing (8) + Snapchat OAuth + WhatsApp agent:

<CardGroup cols={4}>
  <Card title="LinkedIn" icon="linkedin" href="/platforms/linkedin" />

  <Card title="Facebook" icon="facebook" href="/platforms/facebook" />

  <Card title="Instagram" icon="instagram" href="/platforms/instagram" />

  <Card title="TikTok" icon="tiktok" href="/platforms/tiktok" />

  <Card title="YouTube" icon="youtube" href="/platforms/youtube" />

  <Card title="Threads" icon="threads" href="/platforms/threads" />

  <Card title="Pinterest" icon="pinterest" href="/platforms/pinterest" />

  <Card title="Bluesky" icon="bluesky" href="/platforms/bluesky" />

  <Card title="Snapchat" href="/platforms/snapchat" />

  <Card title="WhatsApp" href="/platforms/whatsapp" />
</CardGroup>

## Two ways to integrate

| Method          | Base URL                       | Best for                                         |
| --------------- | ------------------------------ | ------------------------------------------------ |
| **REST API**    | `https://backend.postsiva.com` | Scripts, n8n, Zapier, your backend               |
| **Unified MCP** | `https://mcp.postsiva.com/mcp` | AI agents in Cursor, Claude Desktop, MCP clients |

Both authenticate with the same **workspace API key**. The key resolves your workspace automatically — no `X-Workspace-Id` header required (optional; must match if sent).

## API-first design

Every feature available in the Postsiva web app is exposed programmatically:

* REST endpoints return JSON
* MCP tools mirror the same backend logic as the WhatsApp/website agent
* GPT Actions (`/unified/gpt-actions/*`) expose a REST mirror for ChatGPT Custom GPTs

## How to get started

Use the **Postsiva web app** first, then call the **REST API** (or MCP) with your workspace API key.

<Steps>
  <Step title="Sign up or log in">
    Go to [postsiva.com](https://postsiva.com) — create an account or log in.
  </Step>

  <Step title="Create a workspace">
    Create a **workspace** (or join one via invite). All connected accounts, posts, and API keys belong to that workspace — use the workspace switcher to confirm you're in the right one.
  </Step>

  <Step title="Connect your social accounts">
    Open **Settings → Integrations** and connect LinkedIn, Instagram, Facebook, TikTok, YouTube, Threads, Pinterest, Bluesky, etc. Finish OAuth for each network (Bluesky: handle + app password).
  </Step>

  <Step title="Create a workspace API key">
    Open **Settings → API Keys** (Pro plan). Create a key, copy `psk_live_…` once — this unlocks all [REST APIs](/apis/overview) and [MCP](/mcp/overview).
  </Step>

  <Step title="Call the API">
    Send requests to `https://backend.postsiva.com` with header `X-API-Key: psk_live_…`. Start with the [Quickstart](/quickstart) or [Complete setup](/guides/complete-setup).
  </Step>
</Steps>

<Note>
  API keys and MCP require the **Pro** plan (`api_keys_enabled` + `mcp_enabled`). Free and Starter plans use the web app only.
</Note>

<Card title="All posting parameters" icon="list" href="/apis/posting-parameters">
  Full per-platform body fields for text, image, carousel, and video (LinkedIn pages, Facebook pages, TikTok privacy, YouTube title, Pinterest board, …).
</Card>