Developers

API Reference

Schedule and publish from Claude, Cursor, or your own code. Same accounts and posts as the dashboard. $0 for early users.

Quickstart

  1. Create a key in Dashboard → API
  2. Send Authorization: Bearer ip_… on every request
  3. Base URL: https://www.indiepost.app
bash
curl -sS "https://www.indiepost.app/api/v1/accounts" \
  -H "Authorization: Bearer ip_YOUR_KEY"

Authentication

Keys start with ip_. Pass them as a Bearer token. Never put a key in a public repo or client-side frontend.

http
Authorization: Bearer ip_YOUR_KEY

Endpoints

Pick an endpoint, then switch between request and response.

GET /api/v1/accounts

List workspaces and connected social accounts.

bash
curl -sS "https://www.indiepost.app/api/v1/accounts" \
  -H "Authorization: Bearer ip_YOUR_KEY"

MCP

Same tools for every client — they wrap the v1 API. Claude and Cursor use an API key; ChatGPT signs in with OAuth on a separate URL so the two auth styles stay isolated.

Server URL

url
https://www.indiepost.app/api/mcp

Claude custom connector

  • Auth: No sign-in (not OAuth)
  • Header authorization = Bearer ip_YOUR_KEY
  • Use www.indiepost.app, not the bare domain

Cursor mcp.json

json
{
  "mcpServers": {
    "indiepost": {
      "url": "https://www.indiepost.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ip_YOUR_KEY"
      }
    }
  }
}

Tools: list_accounts list_media init_media_upload delete_media import_media list_posts create_post schedule_batch get_post delete_post get_batch

Limits

Free by default. Pro raises Agent API caps and includes 50 GB library storage.

RuleFreePro
Uploads2 GB / hour5 GB / hour
Posts100 / day500 / day
What countsPost groups / create calls (one post to Instagram + TikTok + YouTube = 1), not per-platform destinations
RetriesSend Idempotency-Key (REST) or idempotencyKey (MCP) on create / batch. Same key + body replays safely; without it, retry creates another post
Batch size50100
XNot available via API
YouTubeRequires title + format (short | long)
TikTokRequires privacyLevel: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, or SELF_ONLY. Optional commercial disclosure (default off): commercialEnabled, commercialYourBrand (Your brand), commercialBrandedContent (paid partnership; not with SELF_ONLY). Photo/carousel only: autoAddMusic (TikTok adds recommended music; defaults false)
Instagram / FacebookFormat optional; video defaults to reel
AI labelOptional per platform: youtube.aiGenerated, tiktok.aiGenerated, instagram.aiGenerated, facebook.aiGenerated

Ready to try it?

Keys live in the developer console after you sign in.

Open console