API operational
All platform guides
Platform guide

Facebook Pages

Requires management access to the Facebook Page you want to connect. Personal profiles cannot be publishing destinations.

approval required63,206 characters10 media items

Capabilities at a glance

AnalyticsSupportedCommentsSupportedMessagesSupportedRemote deletionSupportedToken refreshSupported
01

Connect Facebook Pages

Create the hosted connection URL on your server. The customer completes OAuth or the provider-specific credential form directly on PostGate.

Connection requestPostGate API
curl -X POST https://postgate.studio/api/profiles/connect \
  -H "Authorization: Bearer $POSTGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "platform": "facebook",
  "profile_group_id": "grp_acme123",
  "return_url": "https://app.example.com/settings/social"
}'
02

Publish to Facebook Pages

Use the connected profile ID as the target. Provider-specific fields live under post.options.facebook so the unified envelope remains stable.

Post envelopePostGate API
{
  "post": {
    "body": "Launch day."
  },
  "profiles": [
    "pro_facebook123"
  ],
  "media": [
    "med_01JXYZ"
  ]
}
03

Media and content limits

PostGate validates the request at creation and again at delivery. Account-level provider limits can be narrower than the general contract.

Text63,206 characters
LinksAllowed
Mediaimages and video · Up to 10
Image size10 MB
Video size4 GB
Video durationUp to 240 min
04

Operational notes

These constraints affect approval, connection health, or delivery behavior for this provider.

  • Pages only; app review and business verification required.

  • Stories: set post.options.facebook.mode to 'story' to publish a single photo or video as a Page Story instead of a feed post. Video 3-60s, 9:16, min 540x960px; photo up to 10MB. No permalink is returned.

  • Reels: set post.options.facebook.mode to 'reel' to publish a single 3-90s vertical video as a Page Reel; post.body becomes its description.

  • Published posts: PATCH /api/posts/{id} with only body edits the text of a Facebook feed post on Facebook; DELETE /api/posts/{id}?delete_on_platform=true deletes feed posts and Reels on Facebook first.

Check live capability before showing the option
Call GET /api/platforms. A provider appears only when it is enabled and configured for the current workspace.
Next guideBuild the complete post envelopeCompareAll platform capabilities