Quickstart#
Get started with the Kabonshare API — authenticate, connect your social accounts, and publish your first post in minutes.Kabonshare is a social media management platform that lets you create, schedule, and publish content across all major platforms from a single API. Whether you're building a publishing tool, automating your content workflow, or managing multiple brands, the API gives you full control.Base URL: https://api.kabonshare.com
Authentication#
All API requests require an API key passed in the X-API-Key header.2
Open API Settings
Navigate to Settings → API from the sidebar.
3
Copy your API key
Click Generate Key if you haven't already, then copy the key. Store it somewhere safe — treat it like a password.
Never expose your API key in client-side code or public repositories.
Response Envelope#
Every response — success or error — wraps its payload in the same envelope:{ "status": true, "message": "Human readable", "data": { ... } }
All JavaScript examples below destructure const { data } = await res.json() to access the payload.
Key Concepts#
Workspaces
Containers that group your social accounts and content. You can have multiple workspaces for different brands or clients.
Social Accounts
Connected platform accounts that belong to a workspace. You connect them once via OAuth.
Posts
Content to publish. A single post can be sent to multiple platforms simultaneously, immediately or on a schedule.
Assets
Images and videos stored in your media library. Upload once, reuse across posts.
Get Your First Post Live#
1
Get your workspace ID
Most API calls are scoped to a workspace. Fetch your workspaces and save the
_id.
2
Connect a social account
The endpoint is
GET /api/auth/{platform}/url. It returns an OAuth URL — open it in a browser to authorise the connection.
| Platform | API value | Endpoint |
|---|
| Twitter / X | twitter | GET /api/auth/twitter/url |
| Instagram | instagram | GET /api/auth/instagram/url |
| Facebook | facebook | GET /api/auth/facebook/url |
| LinkedIn | linkedin | GET /api/auth/linkedin/url |
| TikTok | tiktok | GET /api/auth/tiktok/url |
| Threads | threads | GET /api/auth/threads/url |
| YouTube | youtube | GET /api/auth/youtube/url |
| Bluesky | bluesky | GET /api/auth/bluesky/url?handle=name.bsky.social |
Note: Bluesky requires an extra handle query parameter (e.g. name.bsky.social). It uses atproto OAuth — no developer app registration required.3
List connected accounts
After connecting, list your accounts to get the account IDs used when publishing.
4
Publish your first post
Create a post and schedule it for tomorrow at noon.
Post Variations#
Instagram
Stories, reels, carousels, container pre-processing.
Facebook
Pages, native scheduling, reels.
TikTok
Video-first, CDN pre-processing, post approvals.
YouTube
Long-form video, native scheduling, live streaming.
Threads
Text and images, container pre-processing.
Twitter / X
Threads, polls, 280-char limit.
LinkedIn
Articles, company pages, professional content.
Bluesky
atproto OAuth, 300 graphemes, rich text, video via the video service.
What's Next#
Platform Guides
Learn platform-specific requirements, media limits, and content types for each network.
Media Library
Upload and manage images and videos. Reuse assets across posts.
AI Captions
Generate captions from your brand voice. Kabonshare learns from your past posts.
Live Streaming
Go live on YouTube or Facebook. The API returns an RTMP ingest URL for OBS or any broadcast tool.
Analytics
Track follower growth and content performance for each connected platform.
MCP Server
Connect Claude, Cursor, or Windsurf directly to your Kabonshare account via MCP.