Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.postiz.com/llms.txt

Use this file to discover all available pages before exploring further.

NOTE: Please be advised that Instagram and Facebook can use the same app (no need to create two separate apps)
1

Create a new app

Select a business portfolio, then create a new app in Facebook developers.Please be advised that for public applications, you will need to verify your business.Business PortfolioCreate app
2

Select app type

Select “Other” and click nextOther app use cases
3

Select business

Then select businessBusiness
4

Add details and create app

Add all your details and click Create AppCreate app details
5

Set up Login with Facebook

Setup Login with FacebookSet up login for business
6

Configure redirect URI

Set up a redirect URI back to the applicationstep 6Your Facebook OAuth2 Redirect URI:
  • Production: https://your-postiz-domain.com/integrations/social/facebook
  • Local development: http://localhost:4200/integrations/social/facebook
  • Docker: http://localhost:5000/integrations/social/facebook
7

Request advanced permissions

step 7Go to advanced permission and request access for the following scopes:
  • pages_show_list
  • business_management
  • pages_manage_posts
  • pages_manage_engagement
  • pages_read_engagement
  • read_insights
If your Postiz install is for personal use only these advanced permissions are not required for Postiz to function.
8

Set app mode to Live

Change the App Mode from ‘Development’ to ‘Live’. If you do not do this then posts made via the API will display for yourself but will not be visible for other users.
9

Copy your credentials

KeysGo to basic permissions copy your App ID and App Secret and paste them in your .env file
FACEBOOK_APP_ID="app id"
FACEBOOK_APP_SECRET="app secret"
Facebook should now be working!

​
Troubleshooting

​
Image is missing from the published post

Check the App Mode of your Facebook app. In Development mode, posts with media are only visible to app developers/testers — everyone else sees the post without the image. Switch the app to Live mode to make the image visible to all users.

​
Facebook posts work for you but not for other users

Same root cause as above — the app is in Development mode. Only roles you’ve explicitly added (developers, testers, admins) can see content published via the API. Set the app to Live.