Skip to main content
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.
2

Show all use cases

On the “Add use cases” screen, select the “All” filter on the left
3

Select app type

Don’t select any of the use cases. Instead, scroll to the bottom, and under “Looking for something else?” select “Other” and click next
4

Select business

Then select business
5

Add details and create app

Add all your details and click Create App
6

Set up Login with Facebook

Set up login for business
7

Configure redirect URI

Set up a redirect URI back to the applicationYour 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
8

Request advanced permissions

Go 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.
9

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.
10

Copy your credentials

Go to basic permissions copy your App ID and App Secret and paste them in your .env file
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.