ComposioHQ/Facebook Automation

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

1. Connect your Facebook account through the Composio MCP server at https://rube.app/mcp
2. The agent will prompt you with an authentication link if no active connection exists
3. Once connected, all FACEBOOK_* tools become available for execution
4. 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 page
  • page_id (required), fields, limit (max 100)
• FACEBOOK_RESCHEDULE_POST -- Change the scheduled publish time
• FACEBOOK_UPDATE_POST -- Edit caption/text on an existing post
• FACEBOOK_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 Messenger
• FACEBOOK_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