Custom Facebook Identity Provider

Last updated 04/12/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 Set up Facebook Login, then click Next.

Step 3

Step 4

  • For Platform select Website.
  • Select No if you are not building a game. If you are building a game, please contact us for additional instructions.
  • Click Next.
Step 4

Step 5

  • 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 5

Step 6

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

Step 6

Step 7

  • For the Valid OAuth Redirect URIs, enter:

    https://api.breadbutter.io/callback

  • Click Save Changes.
Step 7

Step 8

At the top of the page, click Get Advanced Access.

Step 8

Step 9

Click Edit for Authentication and account creation.

Step 9

Step 10

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

Step 10

Step 11

Click Go backat the top right to return to the main menu.


Step 12

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

Step 12

Step 13

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:

    breadbutter.io

  • Enter your Terms of Service, Privacy policy, and Data Deletion Instructions URLs.

Step 14

  • 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 14

Step 15

Take note of the App ID and App Secret keys.

Step 15

Step 16

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 16

Step 17

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 18

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

Step 18

Step 19

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 19