Skip to main content

​
Overview

Postiz enables you to schedule and publish content to Facebook Pages with support for photos, videos, links, and comprehensive analytics.
Facebook Pages Only: This integration works with Facebook Pages, not personal profiles.

​
Authentication

Facebook uses OAuth 2.0 authentication with long-lived access tokens.
1

Connect Facebook

Click “Connect Facebook Page” in Integrations
2

Grant Permissions

Authorize all requested permissions for full functionality
3

Select Page

Choose which Facebook Page(s) to connect
4

Start Posting

Your page is now ready for scheduling posts

​
Required Permissions

  • pages_show_list - List your pages
  • business_management - Manage business assets
  • pages_manage_posts - Create and manage posts
  • pages_manage_engagement - Respond to comments
  • pages_read_engagement - Read engagement metrics
  • read_insights - Access page insights/analytics

​
Supported Features

​
Content Types

  • Maximum: 63,206 characters
  • Rich text formatting not supported
  • URLs automatically preview

​
Post Settings

​
Media Handling

​
Photo Upload Process

1

Upload Photos

Photos are uploaded individually with published: false
2

Create Post

All uploaded photos are attached to the final post
3

Publish

Post is published with all media attached

​
Video Upload Process

Videos are uploaded as Facebook Reels:
  • Direct upload from URL
  • Automatic Reel formatting
  • Permalink provided after upload
Facebook video posts are automatically formatted as Reels and linked to facebook.com/reel/{id}

​
Comments & Engagement

Add comments to your Facebook posts:
  • Comment on posts and replies to comments
  • Support for media in comments
  • Threading supported
  • Max 63,206 characters per comment

​
Analytics

​
Page-Level Analytics

Track key page metrics over time:
  • Page Impressions: Unique impressions
  • Posts Impressions: Post-specific impressions
  • Post Engagement: Likes, comments, shares
  • Page Follows: New followers
  • Video Views: Total video views

​
Post-Level Analytics

Detailed metrics for individual posts:
  • Impressions: Unique reach
  • Clicks: Link and post clicks
  • Reactions: Total reactions by type (like, love, haha, etc.)
  • Real-time data updates
{
  "label": "Impressions",
  "percentageChange": 0,
  "data": [
    {
      "total": "1234",
      "date": "2024-03-15"
    }
  ]
}

​
Rate Limits

Rate Limits:
  • 100 concurrent posting jobs
  • No strict daily post limit
  • API rate limits apply per page

​
Error Handling

Common Facebook API errors:
Error CodeErrorSolution
190Invalid access tokenReconnect your account
490Token expiredReauthenticate
1366046Photo too largeReduce file size under 4MB
1390008Posting too fastSlow down posting frequency
1346003Abusive contentContent flagged - modify post
1404006Security check requiredComplete Facebook security check
1404078Permission requiredReconnect with full permissions
1609008Cannot post Facebook linksRemove facebook.com URLs
Content Policy: Posts flagged as abusive (error 1346003) cannot be published. Review Facebook’s Community Standards.

​
Page Discovery

Postiz discovers Facebook Pages through:
  1. Direct OAuth Selection: Pages you select during connection
  2. Business Manager: Pages managed through Business Manager
  3. Owned Pages: Pages you own
  4. Client Pages: Pages you manage for clients
This ensures all accessible pages are available for posting.

​
Best Practices

Optimal Post Length

Keep posts under 500 characters for best engagement

Video Performance

Native Facebook videos (Reels) get better reach than linked videos

Image Specs

Use 1200x630px for link previews, 1080x1080px for photo posts

Posting Time

Best engagement: 1 PM - 3 PM weekdays

​
Troubleshooting

If you see “Error validating access token”:
  • Token may have expired (60-day expiry)
  • Reconnect your Facebook account
  • Ensure all permissions are granted
  • Check Facebook session hasn’t been invalidated
If your page isn’t showing:
  • Verify you’re an admin of the page
  • Check Business Manager permissions
  • Try disconnecting and reconnecting
  • Ensure page isn’t restricted
Photo upload problems:
  • Reduce file size (under 4MB)
  • Use JPG or PNG format
  • Check image dimensions aren’t excessive
  • Verify account isn’t rate limited

Build docs developers (and LLMs) love

Get started for freeTalk to us