Composio HQ Facebook Automation
Automate Facebook Page operations -- create and schedule posts, upload videos, manage Messenger conversations, retrieve page insights, and handle scheduled content -- all orchestrated through the Composio MCP integration.
Toolkit docs: composio.dev/toolkits/facebook
Setup
- Connect your Facebook account through the Composio MCP server at
https://rube.app/mcp - The agent will prompt you with an authentication link if no active connection exists
- Once connected, all
FACEBOOK_*tools become available for execution - Note: This toolkit supports Facebook Pages only, not personal Facebook accounts
Core Workflows
1. Discover Managed Pages
List all Facebook Pages you manage to get page IDs and access tokens for subsequent operations.
Tool: FACEBOOK_LIST_MANAGED_PAGES
| Parameter | Type | Required | Description |
|---|---|---|---|
fields |
string | No | Comma-separated fields (default: id,name,access_token,category,tasks,about,link,picture) |
limit |
integer | No | Max pages per request (default: 25) |
user_id |
string | No | User ID (default: me) |
Always run this first to cache page_id values. Avoid repeating discovery calls -- cache the results.
2. Create & Schedule Posts
Publish or schedule text posts with optional links on a Facebook Page.
Tool: FACEBOOK_CREATE_POST
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id |
string | Yes | Numeric Page ID from managed pages |
message |
string | Yes | Text content of the post |
published |
boolean | No | true to publish immediately, false for draft/scheduled (default: true) |
scheduled_publish_time |
integer | No | Unix UTC timestamp; must be at least 10 minutes in the future |
link |
string | No | URL to include in the post |
targeting |
object | No | Audience targeting specifications |
When scheduling: Set published=false and provide scheduled_publish_time as a Unix UTC timestamp.
3. Create & Schedule Video Posts
Upload and schedule video content on a Facebook Page.
Tool: FACEBOOK_CREATE_VIDEO_POST
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id |
string | Yes | Numeric Page ID |
file_url |
string | Conditional | URL of the video file (provide file_url or video) |
video |
object | Conditional | Local file upload with name, mimetype, s3key |
title |
string | No | Video title |
description |
string | No | Video description |
published |
boolean | No | Publish immediately (default: true) |
scheduled_publish_time |
integer | No | Unix timestamp for scheduled publishing |
4. Manage Scheduled Posts
Review, reschedule, update, or publish scheduled content.
Tools:
FACEBOOK_GET_SCHEDULED_POSTS-- List scheduled/unpublished posts for a pagepage_id(required),fields,limit(max 100)
FACEBOOK_RESCHEDULE_POST-- Change the scheduled publish timeFACEBOOK_UPDATE_POST-- Edit caption/text on an existing postFACEBOOK_PUBLISH_SCHEDULED_POST-- Publish a scheduled post immediately
5. Read Page Messenger Conversations
Retrieve inbox conversations and message threads between users and your Page.
Tool: FACEBOOK_GET_PAGE_CONVERSATIONS
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id |
string | Yes | The Facebook Page ID |
fields |
string | No | Fields to return (default: participants,updated_time,id) |
limit |
integer | No | Conversations to return, max 25 |
Then retrieve full message threads:
Tool: FACEBOOK_GET_CONVERSATION_MESSAGES
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id |
string | Yes | Page ID that owns the conversation |
conversation_id |
string | Yes | Conversation ID in t_ format (e.g., t_3638640842939952) |
fields |
string | No | Default: id,created_time,from,to,message |
limit |
integer | No | Messages to return, max 25 |
6. Send Messages & Mark as Seen
Respond to users via Messenger and mark messages as read.
Tools:
FACEBOOK_SEND_MESSAGE-- Send a text message from the Page to a user via MessengerFACEBOOK_MARK_MESSAGE_SEEN-- Mark a user's message as seen by the Page
Warning: Both tools cause user-visible side effects. Only call after explicit confirmation.
Known Pitfalls
| Pitfall | Details |
|---|---|
| Scheduling too close to now | FACEBOOK_CREATE_POST with scheduled_publish_time less than ~10 minutes in the future returns HTTP 400 -- enforce a larger buffer for bulk runs |
| Unix UTC timestamps required | scheduled_publish_time must be Unix UTC -- timezone conversion mistakes cause off-by-hours scheduling or validation failures |
| Cursor-based pagination | FACEBOOK_GET_SCHEDULED_POSTS and FACEBOOK_GET_PAGE_CONVERSATIONS return subsets -- follow paging cursors to get complete data |
| Large conversation payloads | Requesting embedded messages in conversations creates huge payloads -- use FACEBOOK_GET_CONVERSATION_MESSAGES for full threads instead |
| Video processing delays | Uploaded videos may remain in processing state -- only schedule via FACEBOOK_CREATE_VIDEO_POST after the upload is usable |
| Cache page IDs | Repeating FACEBOOK_LIST_MANAGED_PAGES calls adds latency -- cache page_id per workspace/run |
| Pages only | This toolkit does not support personal Facebook accounts -- only Facebook Pages |
| Write operations need confirmation | FACEBOOK_SEND_MESSAGE and FACEBOOK_MARK_MESSAGE_SEEN cause user-visible side effects -- only call after explicit user confirmation |
Quick Reference
| Tool Slug | Purpose |
|---|---|
FACEBOOK_LIST_MANAGED_PAGES |
List Pages you manage with access tokens |
FACEBOOK_GET_PAGE_DETAILS |
Get detailed info about a specific Page |
FACEBOOK_CREATE_POST |
Create or schedule a text/link post |
FACEBOOK_CREATE_VIDEO_POST |
Create or schedule a video post |
FACEBOOK_GET_SCHEDULED_POSTS |
List scheduled/unpublished posts |
FACEBOOK_RESCHEDULE_POST |
Change scheduled publish time |
FACEBOOK_UPDATE_POST |
Edit an existing post |
FACEBOOK_PUBLISH_SCHEDULED_POST |
Publish a scheduled post immediately |
FACEBOOK_UPLOAD_VIDEO |
Upload a video file to a Page |
FACEBOOK_GET_PAGE_CONVERSATIONS |
List Messenger inbox conversations |
FACEBOOK_GET_CONVERSATION_MESSAGES |
Retrieve messages from a conversation |
FACEBOOK_SEND_MESSAGE |
Send a Messenger message from the Page |
FACEBOOK_MARK_MESSAGE_SEEN |
Mark a message as seen |
FACEBOOK_GET_PAGE_POSTS |
Retrieve posts from a Page feed |
FACEBOOK_GET_USER_PAGES |
List Pages with tasks and tokens |
Powered by Composio