Custom Facebook Identity Provider

Last updated 10/03/2023

Step 1

Log in to the developer site of Facebook:

https://developers.facebook.com/


Step 2

Click on My Apps at the top right, then click Create App.


Step 3

Select Allow people to log in with their Facebook account, then click Next.

Step 3

Step 4

  • Enter an App Name. We recommend using your company name for the App name, as this name will appear during the login process.
  • Ensure that your contact email is correct.
  • For Business Account, select your company's business account. Business Account Verification is required to complete this setup process.
  • Click Create app.
Step 4

Step 5

In the left menu, go to Products, then go to Configure > Settings for Facebook Login.

Step 5

Step 6

  • For the Valid OAuth Redirect URIs, enter:

    https://api.breadbutter.io/callback

  • Click Save Changes.
Step 6

Step 7

In the left menu, go to Use cases, then click Edit for Authentication and account creation.

Step 7

Step 8

On the Use case permissions page, click Add for email.

Step 8

Step 9

Click Go back at the top right to return to the main menu.


Step 10

In the left menu, go to Settings, then Basic.

Step 10

Step 11

Fill out all of the fields on this page that you are able to. This will ensure that your app will be approved by Facebook.

  • For App domains enter your website domain.
  • Enter your Terms of Service, Privacy policy, and Data Deletion Instructions URLs.

Step 12

  • At the bottom of the page, click Add Platform.
  • Select Website.
  • For Site URL, set this to your website's URL.
  • Click Save Changes.
Step 12

Step 13

Take note of the App ID and App Secret keys.

Step 13

Step 14

If you see the Complete Data Use Checkup message at the top of the page, click Get Started, then follow the steps on the page to complete the process.

Step 14

Step 15

Go to Verification in the left menu, and follow the steps to verify your business if you have not done so already. Business Verification is required in order to go live.


Step 16

At the bottom of the left menu, click Go Live, then click the Go Live button to set your app to live mode.

Step 16

Step 17

Bread & Butter Setup:

  1. Go to https://app.breadbutter.io/sign-in/
  2. Click Sign In and authenticate (or Sign Up make a new account and authenticate).
  3. Go to Settings in the left menu.
  4. Click on Facebook under SSO Settings > Social Accounts.
  5. Select "Set Facebook for Production".
  6. Enter a custom name and description.
  7. Enter the App ID from the Facebook setup steps above.
  8. Enter the App Secret from the Facebook setup steps above.
  9. Click Save.
  10. Click the checkbox next to your new Facebook provider to enable it.
Step 17