Facebook API and MCP

Publish to the selected Facebook Page using its pageId, not a personal Facebook profile.

Choose a connected Facebook Page. Publishing to personal Facebook profiles is not supported. Get pageId from the account's subaccounts.

Fields

Field	Use
pageId	Required Facebook Page ID.
mediaType	Optional reel or story for the media format.
link	Optional URL for a link preview.
firstComment	Optional first comment after publishing. Stories do not support it.

For MCP, pass platform-specific fields alongside accountId, platform, text, and mediaUrls. For REST, platform-specific target fields belong inside post.target. Thread content belongs inside post.content.additionalPosts.

Media and formats

Publish text or image posts to the Page feed. Videos publish as Reels or Stories. A Story requires media. See the Facebook media section for duration and conversion requirements.

Read Facebook media requirements and upload and conversion rules. Public media URLs go directly in mediaUrls. No upload step required.

MCP example

Call blotato_create_post with the following shape. Replace lookup IDs and example media URLs with returned IDs and your media. Adjust the example's settings to the user's request.

{
  "accountId": "ACCOUNT_ID_FROM_LOOKUP",
  "platform": "facebook",
  "text": "A post for your Facebook Page.",
  "mediaUrls": [],
  "pageId": "PAGE_ID_FROM_LOOKUP"
}

REST example

Send this JSON to POST https://backend.blotato.com/v2/posts with your blotato-api-key header.

{
  "post": {
    "accountId": "ACCOUNT_ID_FROM_LOOKUP",
    "content": {
      "platform": "facebook",
      "text": "A post for your Facebook Page.",
      "mediaUrls": []
    },
    "target": {
      "targetType": "facebook",
      "pageId": "PAGE_ID_FROM_LOOKUP"
    }
  }
}

Verify the result

1. Save the returned postSubmissionId.

2. If processing continues, use blotato_get_post_status or GET /v2/posts/:postSubmissionId.

3. Report the returned status and public URL when supplied.

For scheduling, add scheduledTime or useNextFreeSlot as an MCP argument or a REST top-level sibling of post. See Scheduling and completion rules.

Limits and troubleshooting

Select the Page requested by the user when the account has several Pages. A connected personal Facebook account is the authorization account, rather than the posting destination.

See Facebook account guide, platform help, and the Publish Post reference for options and examples.