Facebook Page Settings

OpenQuok public API provider settings for Facebook Pages — embedded URL on text posts, Stories, and follow-up comments with optional image.

2 min read

Connect your agent today

Draft from chat, review in your calendar, and publish only what you approve.

Start for $0

Quick reference

Property	Value
Identifier	facebook
Connect	GET /api/v1/public/social/facebook
Setup guide	Facebook Page
Character cap	63,206
Main-post media	Text-only OK; photos, multi-photo carousel, or Reel (MP4)

Settings on create post

Flat keys and the facebook nested bucket are both accepted.

Flat CLI / API key	Nested composer bucket	Purpose
post_type / postType	facebook.postType	post (feed/Reel) or story
url	facebook.url	Link preview on text-only feed posts
—	facebook.replies	Follow-up comments after publish

Warning

url is ignored when photos or video are attached. Stories require at least one image or MP4 and do not support follow-up facebook.replies.

{
  "providerSettingsByIntegrationId": {
    "<facebook-integration-id>": {
      "url": "https://example.com/launch",
      "facebook": {
        "replies": [
          {
            "message": "See the chart in this comment",
            "delaySeconds": 60,
            "media": [{ "id": "reply-img", "path": "FILE_PATH_FROM_UPLOAD" }]
          }
        ]
      }
    }
  }
}

Field reference

Field	Type	Required	Notes
post_type / facebook.postType	string	No	post (default) or story
url / facebook.url	string	No	HTTPS link for text-only feed posts
facebook.replies	array	No	Feed posts only — not Stories
facebook.replies[].message	string	Yes (per row)	Comment text
facebook.replies[].delaySeconds	number	Yes (per row)	Delay after previous part
facebook.replies[].media	array	No	Max one image per reply — no video

Follow-up comments

Same-account Page comments use facebook.replies. Optional media allows a single image per reply — upload via POST /api/v1/public/upload first.

Complete example

Text post with link preview:

curl -X POST https://api.openquok.com/api/v1/public/posts 
  -H "Authorization: Bearer opo_your_programmatic_token" 
  -H "Content-Type: application/json" 
  -d '{
    "body": "We just shipped a major update.",
    "scheduledAt": "2026-05-15T14:00:00.000Z",
    "status": "scheduled",
    "integrationIds": ["<facebook-integration-id>"],
    "isGlobal": true,
    "providerSettingsByIntegrationId": {
      "<facebook-integration-id>": {
        "url": "https://example.com/blog/launch"
      }
    }
  }'

Story with one image:

{
  "body": "",
  "scheduledAt": "2026-05-15T18:00:00.000Z",
  "status": "scheduled",
  "integrationIds": ["<facebook-integration-id>"],
  "isGlobal": true,
  "media": [{ "id": "story-1", "path": "FILE_PATH_FROM_UPLOAD" }],
  "providerSettingsByIntegrationId": {
    "<facebook-integration-id>": {
      "post_type": "story"
    }
  }
}