🇺🇸English
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 |
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, , |
4. Manage Scheduled Posts
Review, reschedule, update, or publish scheduled content.
Tools:
FACEBOOK_GET_SCHEDULED_POSTS -- List scheduled/unpublished posts for a page
page_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 |
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 for full threads instead |
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 |
Powered byComposio
Weekly Installs
0
Repository
composiohq/awes…e-skills
GitHub Stars
42.3K
First Seen
Jan 1, 1970
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
