> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postqueen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> PostQueen's hosted API is https://api.postqueen.ai. The public API base is https://api.postqueen.ai/public/v1 and takes the raw API key in the Authorization header, with no Bearer prefix.
> The MCP server for posting is https://api.postqueen.ai/mcp/YOUR_API_KEY (or /mcp with Authorization: Bearer YOUR_API_KEY). docs.postqueen.ai/mcp only searches these docs and cannot post.
> The API key is under Connections > API Keys in the app, and only workspace admins can see it.

# Facebook

> Connect a Facebook Page to PostQueen, what you can post to it, and the limits PostQueen checks before a post is scheduled.

export const ChannelStatus = ({status, children}) => {
  const look = ({
    available: {
      color: 'green',
      label: 'Available'
    },
    'in-review': {
      color: 'yellow',
      label: 'In review'
    },
    soon: {
      color: 'gray',
      label: 'Soon'
    }
  })[status] || ({
    color: 'gray',
    label: status
  });
  return <div className="pq-status not-prose" data-status={status}>
      <Badge color={look.color} shape="pill" size="md">{look.label}</Badge>
      {children ? <span className="pq-status-note">{children}</span> : null}
    </div>;
};

<ChannelStatus status="in-review">Until Meta approves PostQueen's app, only accounts with a role on PostQueen's Meta app can connect Pages and publish.</ChannelStatus>

Schedule posts to the Facebook Pages you manage: text, links, photos, multi-photo posts, video and Page Stories. PostQueen publishes them through Facebook's official API when their time comes.

<div className="pq-visual pq-visual-card pq-tint-lilac">
  <img noZoom src="https://mintcdn.com/forceplay/CEQwaAjYodG7Gh_r/images/site/channels/facebook.webp?fit=max&auto=format&n=CEQwaAjYodG7Gh_r&q=85&s=24e29e59fa8238827421cf0263a815e3" alt="A new Facebook post in the PostQueen composer, with the post types Facebook takes and the time it goes out" width="1200" height="1078" data-path="images/site/channels/facebook.webp" />
</div>

## What you can post

<CardGroup cols={2}>
  <Card title="Text" icon="type">
    Up to 63,206 characters. A text-only post of 130 characters or fewer can sit on a colored background.
  </Card>

  <Card title="Media" icon="image">
    Any number of photos in one post, or one MP4 video. Facebook takes photos up to 10 MB.
  </Card>

  <Card title="Post types" icon="layers">
    Text, link, photo, multi-photo and video posts, and Page Stories with photos or videos.
  </Card>

  <Card title="Analytics" icon="chart-line">
    7, 30 or 90 days: Page reach, media views, post engagement and new follows by day, plus reach, clicks and reactions for each post, and plays, reactions, comments and shares for each Reel.
  </Card>
</CardGroup>

**Not supported:** personal profiles and Groups, Reels as a post type (a video goes to the Page's videos), polls, events, and location or feeling tags.

## Checked before scheduling

PostQueen refuses a post that breaks these rules and shows the message in the composer:

| 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”      |

Photo size and video length are Facebook's rules, and PostQueen does not check them first. Facebook takes photos in JPEG, PNG, GIF, BMP or TIFF up to 10 MB, and story videos up to 60 seconds. When Facebook refuses a post, PostQueen shows its reason, for example "You are posting too fast, please slow down".

## Connect Facebook

You need a Facebook Page and a role on it that can create posts. Personal profiles and Groups cannot be connected.

<Note>
  Facebook is in review. Until Meta approves PostQueen's app, only accounts with a role on that app can finish these steps.
</Note>

<Steps>
  <Step title="Open Add Channel">
    Open **Channels** and choose **Add Channel**, then **Facebook Page**.
  </Step>

  <Step title="Log in with Facebook">
    Log in with the Facebook account that manages the Page. Share the Page when Facebook asks which ones to include, and approve every permission. PostQueen needs all of them.
  </Step>

  <Step title="Pick the Page">
    In **Select Page**, pick one or more Pages and choose **Save**. Pages you manage through Business Manager are listed as well. When there is only one, choose **Connect this channel**.
  </Step>

  <Step title="Check that it connected">
    The Page appears in the **Channels** list with its picture and name.
  </Step>
</Steps>

## Post settings

Each Facebook post in the composer has these settings:

* **Post Type**: **Post** or **Story**. It starts on **Post**. A story needs a photo or a video, and each item goes out as its own story.
* **Embedded URL (only for text Post)**: a link attached to the post.
* **Background**: a colored or illustrated background behind a text-only post of 130 characters or fewer, chosen from 74 presets. Facebook publishes no official list, so the colors are approximate, and a background Facebook no longer accepts is dropped: the post goes out as plain text.

The field names, values and preset ids for the API are on [Facebook posting settings](/public-api/providers/facebook).

## Comments and threads

**Add comment** schedules follow-up comments under the post. Each one replies to the comment before it, has its own delay, and can carry one image. Facebook takes images on comments, not video, and only the first attached item is sent.

## Good to know

* The connection lasts about 59 days. After that the Page shows **Needs reconnecting**: choose **Reconnect channel** in its menu.
* When the first attached item is a video, only that video is published and the other items are ignored. When a photo comes first, every item is sent as a photo.
* Several items in one story post go out as separate stories, one at a time. If a story post is interrupted, PostQueen stops rather than risk posting twice and asks you to check the Page.
* The follower numbers are new follows per day, not a running total. Comments and shares are counted for Reels only.
* During the free trial, a Page that another PostQueen workspace already connected is refused until you end the trial.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Not enough scopes, when choosing a provider, please add all the scopes">
    A permission was switched off on Facebook's screen. Connect the Page again and approve every permission.
  </Accordion>

  <Accordion title="PostQueen is not authorized to publish as this page, please reconnect the channel">
    The Page was not shared with PostQueen during the login. Reconnect the channel and include the Page when Facebook asks which Pages to share.
  </Accordion>

  <Accordion title="Facebook rejected the post due to missing permissions">
    Make sure your Facebook account has full content access to the Page, then reconnect the channel.
  </Accordion>

  <Accordion title="Photos should be smaller than 4 MB and saved as JPG, PNG">
    Facebook refused a photo. Use a smaller JPG or PNG and schedule the post again.
  </Accordion>

  <Accordion title="Confirm your identity before you can publish as this Page">
    Facebook wants an identity check for the Page. Open the Facebook app on your phone and follow its instructions, then schedule the post again.
  </Accordion>

  <Accordion title="You are posting too fast, please slow down">
    Facebook throttled the Page. Space the posts out and try again later.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Create a post" icon="square-pen" href="/using/create-a-post">
    Write once for several channels, then schedule it, save a draft or post now.
  </Card>

  <Card title="Channels and their status" icon="layout-grid" href="/channels/overview">
    Which networks you can connect today, what each one posts, and its text limit.
  </Card>

  <Card title="Post from an AI agent" icon="bot" href="/agents/overview">
    Ask Claude, ChatGPT, Grok Bot or another agent to schedule the post for you.
  </Card>

  <Card title="A post did not go out" icon="triangle-alert" href="/troubleshooting/post-failed">
    Why a post fails and what to do about it.
  </Card>
</CardGroup>