Facebook APIthrough Siar.

At a glance

Account needed: A Facebook Page you manage. Personal profiles cannot be published to through the API.

Media rules

What Siar can do on Facebook

Siar can create comments and replies up to 8,000 characters, and import the comments people leave on your posts.

Publish a post

Put Facebook's payload under data.FACEBOOK and list FACEBOOK in socialAccountTypes. Add other networks to the same request to post to all of them at once.

curl -X POST "https://api.siaran.my/api/v1/post" \
  -H "x-api-key: $SIAR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "teamId": "TEAM_ID",
    "title": "Facebook post",
    "postDate": "2026-11-02T09:00:00.000Z",
    "status": "SCHEDULED",
    "socialAccountTypes": [
      "FACEBOOK"
    ],
    "data": {
      "FACEBOOK": {
        "type": "POST",
        "text": "Hello from Siar",
        "uploadIds": [
          "UPLOAD_ID"
        ]
      }
    }
  }'

Facebook fields

• type string default "POST"
  One of: POST REEL STORY
• text string nullable
• uploadIds string[] nullable
• mediaItems object[] nullable
  2 fields

  • uploadId string required
  • altText string nullable
• link string nullable
• thumbnail string nullable
• mediaTitle string nullable
• nativeScheduleTime string nullable date-time
• textFormatPresetId string nullable

Daily caps

See pricing for monthly quotas. Enterprise uses the Business caps unless agreed otherwise.

Connecting a Facebook account

Siar sends the user to the network's consent page and stores the tokens it gets back, refreshing them before they expire. Use POST /social-account/connect from your own UI, or send your customer a hosted link from POST /social-account/create-portal-link; see connecting accounts.

Permissions requested

Siar requests only these scopes at connect time:

• public_profile
• pages_show_list
• pages_read_engagement
• pages_read_user_content
• pages_manage_posts
• pages_manage_engagement
• pages_manage_metadata
• read_insights
• business_management
• pages_messaging

Facebook-specific operations

These exist for Facebook only and live under /misc/facebook.

When Facebook says no

Siar relays Facebook's error code and message verbatim on the post, next to a status you can act on. The Facebook error reference covers 12 common cases with what each one means and the fix. Open the Facebook error reference.