Facebook posting settings

Every post to a Facebook Page carries a settings object with "__type": "facebook". Every other field is optional: a plain text post needs nothing more. Read the live schema for your channel with Get a channel’s settings.

Fields

Field	Type	Required	What it does
`__type`	string	No	Always `"facebook"`. PostQueen sets it from the channel you post to, so it can be left out.
`post_type`	string	No	`post` (the default) or `story`. A story needs at least one photo or video, and each item goes out as its own story.
`url`	string	No	A link attached to the post. It must be a valid URL. Not used on stories.
`text_format_preset_id`	string	No	A background preset id from the list below, for a text-only post.
`title`	string	No	The title of a video posted to the feed. Used only when the post is a video and `post_type` is `post`; ignored otherwise. Without it, the video carries the post text as its description only.

`text_format_preset_id`

A background shows only when both of these hold. When either fails, the post still publishes, as plain text:

Text only. A post with a photo or a video ignores the preset.
130 characters at most. Longer text drops the background.

Facebook has no API that lists its presets, so PostQueen carries a fixed list, the same one the composer offers. The field is not checked against the list. If Facebook refuses an id, the post is published again without the background.

The 74 background preset ids

Preset id	Background
`106018623298955`	Solid purple
`365653833956649`	Pink tropical plants
`618093735238824`	Brown illustration
`191761991491375`	3D hearts
`2193627793985415`	3D heart-eyes emojis
`200521337465306`	3D flame emojis
`1821844087883360`	Walking yellow illustration
`177465482945164`	Light purple 3D cube pattern
`160419724814650`	Orange with pink illustration
`248623902401250`	3D smiling emoji
`240401816771706`	3D rose emojis
`1868855943417360`	3D crying-laughter emoji
`255989551804163`	Eye pink illustration
`1792915444087912`	Illustration
`1654916007940525`	Light grey illustration
`1679248482160767`	Light blue illustration
`518948401838663`	Pink heart pattern on pink
`423339708139719`	Illustration
`204187940028597`	Solid red
`621731364695726`	Solid red
`518596398537417`	Red illustration
`134273813910336`	Tree red illustration
`217321755510854`	Pink and purple hearts on pink
`323371698179784`	Sunset red illustration
`901751159967576`	Gradient, dark orange-red
`552118025129095`	Brown illustration
`263789377694911`	Apple red illustration
`606643333067842`	Tulip light-orange illustration
`458988134561491`	Cat dark-orange illustration
`548109108916650`	Unicorn red illustration
`175493843120364`	Pink and yellow gradient
`338976169966519`	Stairs beige illustration
`206513879997925`	Spiral beige illustration
`168373304017982`	Cube beige illustration
`1271157196337260`	Solid red
`174496469882866`	Lemon yellow illustration
`862667370603267`	Egg light-yellow illustration
`127541261450947`	Ball green illustration
`218067308976029`	Light grey illustration
`688479024672716`	Gradient, teal light-green
`238863426886624`	Cat light-blue illustration
`301029513638534`	Solid teal
`154977255088164`	Solid teal
`1941912679424590`	Gradient, grey dark-grey
`396343990807392`	Flower teal illustration
`143093446467972`	Blue clouds on dark blue
`161409924510923`	Rocket ship makes heart in sky
`145893972683590`	Solid dark purple
`217761075370932`	Solid blue
`931584293685988`	Wave blue illustration
`148862695775447`	Pink and purple hearts on purple
`100114277230063`	Deep sea blue illustration
`558836317844129`	Spiral purple illustration
`172497526576609`	Watermelon light-purple illustration
`433967226963128`	Solid purple
`197865920864520`	Donut light-purple illustration
`643122496026756`	Pink illustration
`762009070855346`	Balloon light-grey illustration
`228164237768720`	Grey heart pattern on black
`146487026137131`	Rain black illustration
`221828835275596`	Glasses light-grey illustration
`1903718606535395`	Solid red
`1881421442117417`	Solid black
`249307305544279`	Gradient, red-blue
`1777259169190672`	Gradient, purple-magenta
`303063890126415`	Yellow/orange/pink gradient
`122708641613922`	Gradient, dark-grey-black
`319468561816672`	Dark blue illustration
`121945541697934`	Pink illustration
`288211338285858`	Blue illustration
`446330032368780`	Gradient, red
`219266485227663`	Solid magenta
`1289741387813798`	Solid dark red
`1365883126823705`	Solid blue

What PostQueen checks

A post that breaks one of these rules is refused with 400 before it is scheduled:

Rule	Message
A story has at least one photo or video	“Story should have at least one media”
Text up to 63,206 characters	“post is too long, please fix it”

The error body names the channel and the rule:

{
  "statusCode": 400,
  "provider": "facebook",
  "name": "Your Page name",
  "message": "Story should have at least one media"
}

Facebook’s own rules are not checked first: photos in JPEG, PNG, GIF, BMP or TIFF up to 10 MB, and story videos up to 60 seconds. When the first item is an MP4, only that video is published and the other items are ignored. When a photo comes first, every item is sent as a photo.

Examples

Send each body to create a post. Replace YOUR_CHANNEL_ID with the Page’s id from list channels, and each media id and path with the values upload a file returns.

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        { "content": "Our autumn guide is out. Five walks within an hour of the city.", "image": [] }
      ],
      "settings": {
        "__type": "facebook",
        "post_type": "post",
        "url": "https://example.com/autumn-walks"
      }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "Opening night, in pictures.",
          "image": [
            { "id": "MEDIA_ID_1", "path": "https://uploads.postqueen.ai/night-1.jpg" },
            { "id": "MEDIA_ID_2", "path": "https://uploads.postqueen.ai/night-2.jpg" }
          ]
        },
        {
          "content": "Thanks to everyone who came.",
          "image": [{ "id": "MEDIA_ID_3", "path": "https://uploads.postqueen.ai/crowd.jpg" }],
          "delay": 10
        }
      ],
      "settings": { "__type": "facebook", "post_type": "post" }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "Two minutes with our head baker.",
          "image": [{ "id": "MEDIA_ID", "path": "https://uploads.postqueen.ai/baker.mp4" }]
        }
      ],
      "settings": { "__type": "facebook", "post_type": "post" }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [{ "content": "We are open all weekend!", "image": [] }],
      "settings": {
        "__type": "facebook",
        "post_type": "post",
        "text_format_preset_id": "106018623298955"
      }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "",
          "image": [
            { "id": "MEDIA_ID_1", "path": "https://uploads.postqueen.ai/story-1.jpg" },
            { "id": "MEDIA_ID_2", "path": "https://uploads.postqueen.ai/story-2.mp4" }
          ]
        }
      ],
      "settings": { "__type": "facebook", "post_type": "story" }
    }
  ]
}

In the photos example, the second entry in value is a follow-up comment, posted 10 minutes after the post. Each comment replies to the one before it and can carry one image. Only the first attached item is sent, and Facebook takes images on comments, not video.

Get started

Endpoints

Posting settings by network

Build on PostQueen

SDK and no-code

Fields

`text_format_preset_id`

What PostQueen checks

Examples

​Fields

​text_format_preset_id

​What PostQueen checks

​Examples

​Related

Fields

`text_format_preset_id`

What PostQueen checks

Examples

Related