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
- Create a key in Dashboard → API
- Send
Authorization: Bearer ip_…on every request - Base URL:
https://www.indiepost.app
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.
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.
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
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
{
"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.
| Rule | Free | Pro |
|---|---|---|
| Uploads | 2 GB / hour | 5 GB / hour |
| Posts | 100 / day | 500 / day |
| What counts | Post groups / create calls (one post to Instagram + TikTok + YouTube = 1), not per-platform destinations | |
| Retries | Send Idempotency-Key (REST) or idempotencyKey (MCP) on create / batch. Same key + body replays safely; without it, retry creates another post | |
| Batch size | 50 | 100 |
| X | Not available via API | |
| YouTube | Requires title + format (short | long) | |
| TikTok | Requires 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 / Facebook | Format optional; video defaults to reel | |
| AI label | Optional per platform: youtube.aiGenerated, tiktok.aiGenerated, instagram.aiGenerated, facebook.aiGenerated | |
Ready to try it?
Keys live in the developer console after you sign in.