POSTARYX

Facebook

How to add Facebook to your system

These are your credentials with the platform, not Postiz credentials.

The keys on this page belong to a developer app you register with the platform. Nobody from Postiz will ever ask for them.

Keep them in your environment or a secret manager, never in a committed .env file, and rotate them at the platform if they leak.

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

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 Portfolio

Create app

Show all use cases

On the "Add use cases" screen, select the "All" filter on the left

All use cases

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

Other app use cases

Select business

Then select business

Business

Add details and create app

Add all your details and click Create App

Create app details

Set up Login with Facebook

Setup Login with Facebook

Set up login for business

Configure redirect URI

Set up a redirect URI back to the application

step 6

The OAuth2 Redirect URI is the location where the provider will redirect to after a successful login. This needs to be set to your Postiz FRONTEND_URL + /integrations/social/ + {provider}.

You only need to set one OAuth2 Redirect URI when you are setting up your Postiz app.

Your 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

Request advanced permissions

step 7

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.

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.

Copy your credentials

Keys

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