Facebook — Postli docs

Home / Docs / Facebook

Provider

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

Account type

Facebook Page (admin or editor role)

Auth

Meta OAuth 2.0 (Facebook Login for Business)

Token type

Long-lived Page access token (no fixed expiry while user token is valid)

Post types

Text, image (single or multi), video, link

Text body

Up to 63,206 characters (effectively unlimited)

Image

JPEG, PNG, BMP, TIFF · ≤4 MB · max 30 MB recommended via resumable upload

Video

MP4, MOV · ≤4 GB or 240 minutes

Link preview

Auto-generated by Meta from the first URL in the body

Auto-comments

Supported — Instant, Time, LikeCount conditions

Connect your Facebook Page

Postli manages the OAuth app centrally — you don’t need to create a developer app or paste any API credentials. Go to Integrations → Facebook → Connect and approve the permissions on Facebook’s OAuth dialog. Postli then requests a long-lived user token and exchanges it for a per-Page token for each Page you select.

Already connected Instagram? The same Meta OAuth flow covers both providers — if you’ve already connected Instagram, Facebook Page publishing is authorised too.

Scopes Postli requests:

pages_show_list # list Pages the user manages pages_manage_posts # publish & delete posts pages_read_engagement # reactions, comments, insights pages_manage_engagement # auto-comments & reply pages_read_user_content # read user comments on Page business_management # Business Manager scope public_profile # default identity scope

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.