# Facebook capabilities

Canonical URL: https://www.outstand.so/facebook.md
Last updated: November 2026 (2026-11-22)
API value of `network`: `facebook`

What the Outstand REST API and MCP server can do on Facebook. "n/a" means the caller sets nothing for that feature or the MCP server does not expose it.

## Publishing

| Feature | Supported | REST | MCP | Notes |
| --- | --- | --- | --- | --- |
| Page posts with text, photos or video | Yes, Pages only | `POST /v1/posts` | `create_post` | Standard video upload: up to 1 GB and 20 minutes. Resumable upload: up to 1.75 GB and 45 minutes. |
| Reels | Yes, exactly one video | `facebook.publishAsReel: true` | `create_post: facebook.publishAsReel` | 9:16 recommended, 3 to 90 seconds. Cannot be combined with publishAsStory. |
| Stories | Yes, one image or video, no caption | `facebook.publishAsStory: true` | `create_post: facebook.publishAsStory` | No caption, comments or mentions. Stories expire after 24 hours. |
| Link posts and link carousels | Yes | `facebook.link, facebook.callToAction, facebook.childAttachments (2 to 5 cards)` | `create_post: facebook.link, facebook.callToAction, facebook.childAttachments` | Link posts cannot carry root media. Per-card call-to-action rendering is experimental. |
| Video cover image | Yes | `facebook.videoCoverUrl` | `create_post: facebook.videoCoverUrl` | Public JPEG up to 10,000,000 bytes, one video, not for Stories. Applied best-effort after publishing. |
| Tag other Pages | Yes, in comments only | `facebook.mentions (pageId, text)` | `create_post: facebook.mentions` | Meta resolves Page tags only in comments, not in the post body. Personal profiles cannot be tagged. |
| First comment | Yes | `containers: second container is posted as a comment` | `create_post: containers` |  |
| Scheduling | Yes, up to 30 days ahead | `POST /v1/posts: scheduledAt (ISO 8601)` | `create_post: scheduledAt` | A later timestamp is rejected with 400 and no post is created. |

## Analytics

| Feature | Supported | REST | MCP | Notes |
| --- | --- | --- | --- | --- |
| Post metrics | Yes | `GET /v1/posts/{id}/analytics` | `get_post_analytics` | Likes (LIKE reaction only), comments, shares, impressions, reach and engagement_rate. Values Meta does not report are null. Needs the Analyze task on the Page. |
| Video and Reel watch time | Yes | `GET /v1/posts/{id}/analytics: metrics.views, average_watch_time_ms, total_watch_time_ms` | `get_post_analytics` | Reels also return total_plays, replays and followers_gained. Regular videos return approx_completion_rate. Meta has no completion rate for Reels. Missing values are null. |
| Retention graph | Yes, REST only | `GET /v1/posts/{id}/analytics?include=retention` | n/a | The MCP tool returns the video metrics but not the retention graph. |
| Audience demographics | Followers only: country and city | `GET /v1/social-accounts/{id}/audience-demographics?breakdown=country\|city` | `get_audience_demographics` | Meta retired Page age, gender and language metrics, so those are not available. Pages need at least 100 followers. |
| Account metrics | Yes | `GET /v1/social-accounts/{id}/metrics` | `get_account_metrics` | Impressions, reach and post engagements for the period. |

## Engagement

| Feature | Supported | REST | MCP | Notes |
| --- | --- | --- | --- | --- |
| Comments and replies | Yes | `POST /v1/posts/{id}/replies, GET /v1/posts/{id}/replies` | `create_reply, get_replies` |  |
| Comment webhooks | Yes | `Webhook event comment.received` | n/a | Covers every post the Page owns. The event carries authorName; authorUsername is null. |
| Direct messages (Messenger) | Yes | `Conversations API: /v1/conversations` | n/a | Free-form replies only within 24 hours of the last inbound message (platform limit). A Page cannot message someone first. |
| Comment-to-DM | Yes | `POST /v1/conversations with facebook.comment_id` | n/a | Platform limit: one private reply per comment, within 7 days. |
| Deleting a published post | Yes | `DELETE /v1/posts/{id}/remote` | `delete_remote_post` |  |
| Reposts | No | n/a | n/a | Reposting is not supported by the Facebook API for Pages. |

## Limits

- Platform limit: Meta applies Business Use Case rate limits per Page, not a fixed posts per day. Calls allowed in a rolling 24 hours are 4,800 times the number of engaged users.
- Meta did not backfill its June 2026 change from impressions to media views, so impression and reach numbers are not comparable across 15 June 2026.
- Managed Keys are included with the subscription; BYOK is optional and only needed to white-label.

## Not supported

- Personal profiles: only Pages are supported.
- Reposts.
- Age, gender and language audience breakdowns.

## Links

- Documentation: https://www.outstand.so/docs/configurations/facebook
- Pricing: https://www.outstand.so/pricing.md
- FAQ: https://www.outstand.so/faq.md
- Search the public docs: https://www.outstand.so/ask.md?q=Facebook%20
- All capability sheets: https://www.outstand.so/capabilities.md
