Facebook

Publish to Facebook Pages you administer. Postli supports text, image, video, and link posts using the Meta Graph API. Personal profiles cannot be posted to via API and are not supported.

Requirements

• A Facebook Page — not a personal profile.
• Admin or Editor role on that Page during the OAuth grant.
• Your Facebook account in good standing — restricted accounts cannot generate Page tokens.

Spec

Create your Meta app

Facebook Page publishing is gated on a Meta app you control. The same app covers Instagram-via-Page — you only need to set it up once.

1. Go to developers.facebook.com/apps and click Create app. Use the Facebook account that admins your Business Manager.
2. Pick Other as the use case, then Business as the app type, and link your Business portfolio.
3. Add the Facebook Login for Business product. Under Settings, register the Valid OAuth Redirect URI:
   https://app.usepostli.com/api/integration/meta/callback
4. In App Review → Permissions and Features, request advanced access for pages_show_list, pages_manage_posts, pages_read_engagement, pages_manage_engagement, pages_read_user_content, and business_management. Add read_insights if you also want Page-level analytics. Provide a screen-recording of the Postli connect flow when submitting.
5. Switch the app from Development to Live. Posts published in Development mode are visible only to test users.
6. From App Settings → Basic, copy the App ID and App Secret.
7. In Postli, open Settings → Integrations → Meta, paste both values, and save.

OAuth setup

Once credentials are saved, go to Integrations → Facebook → Connect. After Facebook’s OAuth dialog, Postli requests a long-lived user token, then exchanges it for a per-Page token for each Page you select.

Scopes Postli requests:

Post types in detail

Text post

Body up to ~63k characters. Hashtags and @mentions render natively. URLs in the body are auto-unfurled into a link card unless suppressed.

Image post

One or more images (multi-photo posts use the /photos endpoint). For multi-image, the first image becomes the post’s cover in News Feed.

Video post

Single video uploaded with caption. Postli uses Meta’s resumable upload protocol for files larger than 4 MB to avoid timeouts.

Link post

Pure link share — Meta unfurls the destination into a card. Postli’s short links unfurl correctly because the redirect returns a 301 to your destination, which then provides the OG tags Meta scrapes.

Auto-comments

All three condition types are supported. Auto-comments post as the connected Page (not a personal profile).

Rate limits

Meta enforces a rolling app-wide rate limit (200 calls/user/hour). Postli’s queue worker batches and back-offs automatically. For typical merchant volume (<100 posts/day) you will not encounter throttling.

Gotchas & best practices

• Personal profile posting is not supported by Meta’s API. You must publish to a Page.
• Token cascade. If the user token is revoked (password change, app removed, role change), the Page tokens derived from it stop working too. Reconnect from Integrations.
• Link unfurling depends on your destination. Make sure your storefront serves og:title, og:image, and og:description — the short-link redirect doesn’t set them; the destination does.
• Editor role is enough. You don’t need full Page admin to publish.

Webhooks

Postli does not subscribe to Page-level webhooks. Engagement is polled on a schedule.