Nitty Music Social Management

Social platforms

Facebook

How to add Facebook to your system

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 Portfolio

Create app

2

Show all use cases

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

All use cases

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

Other app use cases

4

Select business

Then select business

Business

5

Add details and create app

Add all your details and click Create App

Create app details

6

Set up Login with Facebook

Setup Login with Facebook

Set up login for business

7

Configure redirect URI

Set up a redirect URI back to the application

step 6

Your Facebook OAuth2 Redirect URI:

  • Production: https://your-social-domain.com/integrations/social/facebook
  • Local development: http://localhost:4200/integrations/social/facebook
  • Docker: http://localhost:5000/integrations/social/facebook
8

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 Nitty Music Social install is for personal use only these advanced permissions are not required for Nitty Music Social 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

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.