Kabon Share API
    • Overview
    • MCP
    • Platforms
      • Bluesky
      • Instagram
      • Tiktok
      • Linkedin
      • Youtube
      • Facebook
      • Threads
      • Twitter
    • User Auth
      • Sign up
        POST
      • Verify email OTP
        POST
      • Resend OTP
        POST
      • Login with email & password
        POST
      • Sign in / sign up with Google
        POST
      • Request password reset email
        POST
      • Reset password with token
        POST
      • Refresh JWT token
        POST
    • Users
      • Get current user profile
        GET
      • Update current user profile
        PATCH
      • Get all user settings
        GET
      • Update publishing settings
        PATCH
      • Update notification settings
        PATCH
      • Update UI preferences
        PATCH
      • Get current billing usage
        GET
      • List saved payment methods
        GET
      • List billing transactions
        GET
      • Regenerate API key
        POST
      • Mark onboarding complete
        PATCH
      • Create a new user and get API key
        POST
      • Unregister a device from push notifications
        DELETE
      • Get list of registered devices
        GET
      • Register a device for push notifications
        POST
      • Send a test push notification to the current user
        POST
      • Remove the profile picture
        DELETE
      • Upload a profile picture. Stored in the avatars folder, served via the
        POST
      • Delete a payment method
        DELETE
      • Set a payment method as default
        PATCH
      • Download the invoice/receipt PDF for a captured (succeeded) transaction
        GET
    • Social Accounts
      • Get OAuth authorization URL
      • List connected social accounts
      • Disconnect a social account
      • Get creator info for an account
      • List available Facebook Pages
      • Connect a Facebook Page
      • List connected Facebook Pages for a workspace
      • List available LinkedIn organizations
      • Connect a LinkedIn organization
      • List a Pinterest account's boards
      • Create a new Pinterest board for the connected account
      • Validate TikTok creator info
      • Preview the scheduled posts that would be cancelled if this account is
    • Workspaces
      • List workspaces for current user
      • Create a workspace
      • Get a workspace
      • Update a workspace
      • Delete a workspace
      • Update workspace AI settings
    • Team
      • List available permission scopes
      • List pending invitations for the current user
      • Get invitation details by token
      • Accept a workspace invitation
      • Decline a workspace invitation
      • List workspace members
      • Invite a user to the workspace
      • List pending invitations for a workspace
      • Cancel / revoke an invitation
      • Resend an invitation email
      • Update member role / scopes
      • Remove a member from the workspace
      • Leave a workspace
      • Upload a single chat attachment (≤5 MB) to S3 and return { name, url, fileType }
      • Channels the user can see: all workspace channels + DMs they're a member of
      • Create a channel or DM
      • /
      • /
      • /
      • /
      • Get groups
      • Create groups
      • Delete groupId
      • Update groupId
      • Get roles
      • Create roles
      • Delete roleId
      • Update roleId
    • Posts
      • List posts
      • Create a post
      • List upcoming scheduled posts
      • Delete multiple posts
      • Get a post
      • Update a post
      • Delete a post
      • Get analytics for a post
      • Reschedule a post
      • Retry a failed post
      • Cancel a scheduled post
      • Publish a draft post
      • Submit a post for approval
      • Record an approval decision
      • Get post version history
      • Rich, board-ready view of everything in the approval pipeline for the
      • All posts belonging to one Bulk Scheduler batch, in schedule order
      • Summaries of every batch created by the Bulk Scheduler in this workspace —
      • Create bulk
      • Aggregated dashboard metrics computed across ALL posts in the workspace
      • Ping the pending approvers of the post's current open stage
      • /
      • Body: { body, mentions?: [userId], attachments? }
      • /
      • /
      • Deliberately release a 'ready' post (an immediate post that has cleared
    • Assets
      • List assets
      • Bulk delete assets
      • Upload asset directly (multipart)
      • Get signed upload URL (step 1 of 2)
      • Confirm signed upload (step 2 of 2)
      • Get storage usage summary
      • List asset folders
      • Create a folder
      • Rename a folder
      • Delete a folder
      • List asset tags
      • Check thumbnail generation status
      • Get an asset
      • Update asset metadata
      • Delete an asset
      • Batch-resolve asset metadata (name, type, url, thumbnail) for a list of IDs
    • Uploads
      • Get a signed upload URL for post media
      • Get upload file info
      • Delete an uploaded file
      • List uploads
      • Confirm upload complete
      • Create validate url
    • Analytics
      • Get platform aggregate stats
      • Get platform stats as a time series
      • Get audience demographics for a platform
      • List content analytics for a platform
      • Get analytics for a specific content item
      • Delete a synced content record
      • Get time series for a specific content item
      • Get follower count trend over time
      • Get recommended posting times per platform
      • Get aggregated analytics for a post across platforms
      • Gather data → render HTML → print to PDF (Puppeteer) → stream as a download
      • Generate the AI analysis on demand so the builder can preview it before export
      • For the report builder: gathers (and caches) the data, then returns the list of
      • Renders the analytics report as a self-contained HTML page so the template
    • Streams
      • List streams
      • Create a stream
      • Get a stream
      • Delete a stream
      • Go live
      • Stop a live stream
      • Broadcast from a file
      • Update a stream
      • Check relay health and list active paths
      • Get relay status for a specific stream
      • Get streaming usage for the authenticated user (minutes, limits, active streams)
      • the relay (path + token) and re-arm fan-out, returning the WHIP URL so
    • Plans
      • List available subscription plans
    • Subscriptions
      • Get current subscription & credit balances
      • Renew or extend subscription
      • Wallet balances and recent ledger entries
      • Cancel subscription
      • Choose the term for the next renewal
      • Turn recurring billing on or off. Body: { enabled: boolean }
      • Get extra accounts
      • Create cancel removal
      • Create remove
    • Support
      • List support tickets
      • Create a support ticket
      • Get ticket statistics
      • Get a ticket
      • Reply to a ticket
      • Upload a ticket attachment
    • AI
      • Generate caption & hashtags for a media asset
      • Transcribe audio or video
      • Poll async AI job status
      • Get saved captions for an asset
      • Get AI credit usage summary for the workspace
      • Get AI credit usage as a chart series
      • Derive AI style settings from past posts
      • /
      • /
      • /
      • /
      • /
      • /
      • ?limit=30 (default 30, max 100)
      • /
    • Studio
      • List studio projects
      • Create a studio project
      • Get a studio project (includes full projectData)
      • Update a studio project
      • Delete a studio project
    • Payments
      • Pay for a purchase with wallet credit
      • Charge a saved payment method (for recurring subscriptions or credit purchases)
      • Get payment configuration for frontend (public key, supported currencies, etc.)
      • Create cryptocurrency payment invoice via Heleket
      • Initialize a payment (subscription or credit purchase)
      • Verify a payment
    • Bluesky OAuth
      • atproto client metadata
      • atproto client public keys (JWKS)
      • atproto OAuth callback
    • Apps
      • Public — list all active apps with their latest active version
      • Public — single app with all active versions
      • Public — download/redirect to latest version
      • Public — download specific version
    • Billing
      • Get user's billing cycles (all statuses for full history)
      • Calculate proration for upgrading cycles (no charge, just preview)
      • Manually create billing cycles from an existing transaction (admin/fix tool)
      • Select a plan after account creation (for free plans or initial plan selection)
      • Upgrade billing cycles to a new plan with proration
      • Preview the discount a coupon yields for a subscription checkout, so the
    • Blog
      • Published categories with post counts
      • Published posts, newest first. Query: page, limit (max 100), category
      • Single published post by slug
    • Books
      • List available books (metadata only — no file data)
      • Download a book's full JSON data from storage (S3 or local)
    • Platforms
      • Returns obfuscated platform capabilities for frontend
      • Returns capabilities for a specific platform
    • Ideas
      • Get ideas
      • Create ideas
      • Get boards
      • Create boards
      • Delete boardId
      • Update boardId
      • Delete ideaId
      • Get ideaId
      • Update ideaId
      • Get comments
      • Create comments
      • Delete commentId
      • Create convert
      • Update move
      • Create vote
    • Notifications
      • The current user's notification inbox (newest first) + unread count
      • Mark all of the user's notifications read
      • Lightweight unread badge count
      • Mark a single notification read
    • Queue
      • Clean old jobs from the queue
      • Clear jobs from the queue
      • Drain the queue (remove all jobs)
      • Get all jobs in the queue
      • Get queue statistics
    • Limits
      • Create archive
      • Create unarchive
      • Create remove
      • Create restore
      • Create suspend
      • Get status
      • Create archive
      • Create unarchive
    • Services
      • List all available service names
      • Get status of all services (public endpoint)
      • Get status of a specific service (public endpoint)
    • Approvals
      • Delete approval flow
      • Get approval flow
      • Replace approval flow
      • Create resolve stage
    • Schemas
      • ApiResponse
      • SuccessResponse
      • ErrorResponse
      • Pagination
      • User
      • SocialAccount
      • Workspace
      • PlatformPost
      • PlatformValidationFailure
      • Asset
      • PostContentOverride
      • PostApproval
      • Ticket
      • Plan
      • Post
      • Stream
      • StudioProject
      • AiJob
      • WalletEntry
      • Subscription

    Overview

    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.
    INFO
    Base URL: https://api.kabonshare.com

    Authentication#

    All API requests require an API key passed in the X-API-Key header.
    1
    Log in to Kabonshare
    Go to kabonshare.com and sign in to your account.
    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.
    WARNING
    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.
    cURL
    JavaScript
    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.
    cURL
    JavaScript
    Supported platforms:
    PlatformAPI valueEndpoint
    Twitter / XtwitterGET /api/auth/twitter/url
    InstagraminstagramGET /api/auth/instagram/url
    FacebookfacebookGET /api/auth/facebook/url
    LinkedInlinkedinGET /api/auth/linkedin/url
    TikToktiktokGET /api/auth/tiktok/url
    ThreadsthreadsGET /api/auth/threads/url
    YouTubeyoutubeGET /api/auth/youtube/url
    BlueskyblueskyGET /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.
    cURL
    JavaScript
    4
    Publish your first post
    Create a post and schedule it for tomorrow at noon.
    cURL
    JavaScript

    Post Variations#

    Post to multiple platforms at once
    Publish immediately
    Save as a draft
    Attach media

    Platform Guides#

    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.
    Modified at 2026-06-04 13:39:00
    Next
    MCP
    Built with