Kabon Share API
    • Overview
    • MCP
    • Instagram
    • Tiktok
    • Linkedin
    • Youtube
    • Facebook
    • Threads
    • Twitter
    • Bluesky
    • 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
    • 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
      • Validate TikTok creator info
    • 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
    • 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
      • Cancel a scheduled post
      • Retry a failed post
    • 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
    • Uploads
      • Get a signed upload URL for post media
      • Confirm upload complete
      • Get upload file info
      • Delete an uploaded file
      • List uploads
    • 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
    • Streams
      • List streams
      • Create a stream
      • Get a stream
      • Update a stream
      • Delete a stream
      • Go live
      • Stop a live stream
      • Broadcast from a file
    • Plans
      • List available subscription plans
    • Subscriptions
      • Get current subscription & credit balances
      • Renew or extend subscription
      • Cancel subscription
    • 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
    • Studio
      • List studio projects
      • Create a studio project
      • Get a studio project (includes full projectData)
      • Update a studio project
      • Delete a studio project
    • Schemas
      • ApiResponse
      • SuccessResponse
      • ErrorResponse
      • Pagination
      • User
      • SocialAccount
      • Workspace
      • PlatformPost
      • Post
      • Asset
      • Ticket
      • Plan
      • Stream
      • StudioProject
      • Subscription
      • AiJob

    Facebook

    Publish posts, Reels, Stories, and live streams to Facebook Pages. Supports text, images, videos, and GIFs.

    Quick Reference#

    PropertyValue
    Max text length63,206 characters
    Max images per post10
    Max image size4 MB
    Image formatsJPEG, PNG, GIF, BMP, WebP
    Video formatsMP4, MOV
    Max video size4 GB
    Max video duration (feed)240 minutes
    Max video duration (story)120 seconds
    SchedulingSupported (10 min – 75 days ahead)
    Delete via APIYes

    Before You Start#

    WARNING
    The API only works with Facebook Pages, not personal profiles. You must have admin or editor role on the Page to connect it.
    INFO
    While Facebook technically allows up to 63,206 characters, posts are truncated at around 480 characters in the feed with a "See more" link. Keep important content in the first 480 characters.

    Content Types#

    Feed Post
    Text, images, or video. Up to 10 images or 1 video. Schedule up to 75 days ahead.
    Reel
    Short vertical video, 15–90 seconds (enforced). Appears in the Reels tab and feed.
    Story
    Vertical photo or video. Disappears after 24 hours. Videos up to 120 seconds.
    Live Stream
    Real-time broadcast via RTMP. Returns an ingest URL for OBS or any encoder. Page-only.

    Specs#

    Feed Post
    Reel
    Story
    Live Stream

    Features#

    FeatureSupported
    SchedulingYes (10 min – 75 days)
    Delete via APIYes
    Geo-restrictionYes (up to 25 countries)
    Live streamingYes
    AnalyticsImpressions, likes, comments, shares

    Limitations#

    Cannot post to personal profiles. Facebook Pages only.

    Troubleshooting#

    SymptomCause / Fix
    "Cannot go live"Your Page must have at least 100 followers and be at least 60 days old. Both are enforced by Facebook at the API level.
    Reel rejectedDuration must be between 15 and 90 seconds, and the video must be vertical (9:16).
    Image upload silently failsBMP support is technically allowed but rare — prefer JPEG, PNG, or WebP for reliable delivery.
    Personal account rejectionThe Facebook API only accepts Pages, not personal profiles. Connect a Page that you have admin/editor rights to.
    Scheduled post never publishesScheduled time must be at least 10 minutes ahead and at most 75 days ahead; outside that window the API will refuse the request.
    Live stream not appearing on PageThe stream is created in UNPUBLISHED state. After your encoder is connected to the RTMP URL, call go_live to flip the status to LIVE_NOW.
    Modified at 2026-05-20 18:44:36
    Previous
    Youtube
    Next
    Threads
    Built with