Facebook Auto-Poster API
Automate your social media presence. This API enables instant publishing or drafting of text updates, photo posts, and video content to any managed Facebook Page via public media URLs.
Connect this API to an AI agent Browse all specs
What you can do with Facebook Auto-Poster API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| POST | /{pageId}/feed |
postTextMessageToPage | Publish a text post or a post with an embedded link Method: POST Path: /{pageId}/feed IMPORTANT: This function has 2 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - pageId: Numeric ID of the Facebook Page (Facebook Page ID) Request Body: REQUIRED: - message: The main content or caption of the post OPTIONAL: - link: Optional URL link attached to the post - published: True = Publish immediately, False = Save as draft |
| POST | /{pageId}/photos |
postPhotoToPage | Publish a photo post to the Facebook Fanpage Method: POST Path: /{pageId}/photos IMPORTANT: This function has 2 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - pageId: Numeric ID of the Facebook Page Request Body: REQUIRED: - url: Public URL pointing to the image file OPTIONAL: - caption: Text caption or description for the photo - published: published parameter from application/json |
| POST | /{pageId}/videos |
postVideoToPage | Publish a video file to the Facebook Fanpage Method: POST Path: /{pageId}/videos IMPORTANT: This function has 2 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - pageId: Numeric ID of the Facebook Page Request Body: REQUIRED: - file_url: Public URL pointing to the video file OPTIONAL: - title: Title of the video - description: Description or caption for the video |
Usage guide
## Getting Credentials for Facebook API To use this integration, you need a **Facebook Page Access Token**. Follow these steps to obtain your credentials: ### Step 1: Create a Meta Developer App 1. Go to [Meta for Developers](https://developers.facebook.com/) and log in with your Facebook account. 2. Navigate to **My Apps** and click **Create App**. 3. Select **Other** > **Business** as your app type. 4. Enter your App Name and Contact Email, then click **Create App**. ### Step 2: Generate Page Access Token via Graph API Explorer 1. On the top menu, go to **Tools** > **Graph API Explorer**. 2. In the right sidebar under **Meta App**, select the app you just created. 3. Under **User or Page**, select **Get Page Access Token**. 4. Authenticate your Facebook account and grant the app access to the specific Facebook Page you want to manage. 5. Add necessary permissions in the "Permissions" dropdown: - For Auto-Posting: Add `pages_manage_posts`, `pages_show_list`. - For Reading Insights/Posts: Add `pages_read_engagement`, `pages_read_user_content`. 6. Click **Generate Access Token**. ### Step 3: Authenticate the Agent Copy the generated Access Token (a long string of characters) and paste it into the Authentication/API Key field of this plugin. > **Important Note:** Short-lived access tokens expire after 1-2 hours. To keep your agent running continuously, please use the [Access Token Debugger](https://developers.facebook.com/tools/debug/accesstoken/) to extend it to a **Long-Lived Page Access Token** (which never expires).
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Facebook Auto-Poster API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.