Facebook

Need a hand? Setting up developer credentials can sometimes feel a bit overwhelming. We offer a complimentary 15-minute onboarding session to help you get this configured perfectly. Book your session with a specialist here


When you first install Bread & Butter, Facebook may not display your own branding during the connection process if it is not fully configured for your domain.

To maximize user trust and prevent conversion drop-off, you must set up an application in the Facebook Developer portal. This allows you to generate your own credentials so buyers see your brand and logo when they click "Continue with Facebook."

Here is how to set it up in five steps.


Step 1: Create Your Facebook App

  1. Log in to the Facebook Developer website.
  2. Click on My Apps at the top right, then click Create App.

  3. Enter an App Name. We highly recommend using your exact company name, as this is what will appear to users during the login process. Ensure your contact email is correct, then click Next.

  4. Select Authenticate and request data from users with Facebook Login, then click Next.

  5. Choose to connect this app to a business portfolio (recommended). If you are unsure or do not have one ready, choose "I don't want to connect a business portfolio yet".

  6. Review the overview, note the required actions you'll need to complete later to publish your app, and click Go to dashboard.


Step 2: Configure Authentication & Branding Settings

This ensures your app requests the correct data and looks trustworthy to your visitors.

  1. On the Dashboard, click on Customize for the "Authenticate and request data from users with Facebook Login" use case.

  2. Find the email permission and click Add to ensure you capture the user's email address during conversion.

  3. In the menu under Facebook Login, click Settings. For the Valid OAuth Redirect URIs, paste the following exact link: https://api.breadbutter.io/callback

    Click Save Changes.

    In the collapsed left menu, click the gear icon to go to App Settings, then select Basic.

    Fill out all the required compliance and branding fields to ensure Facebook ultimately approves your app:

    • Under App domains, enter your website domain.
    • Enter the exact URLs for your Terms of Service, Privacy policy, and Data Deletion Instructions.
    • Add an App icon and choose an appropriate Category for your business.

  4. Scroll to the bottom of the page and click Add Platform. Select Website, enter your website's URL for the Site URL, and click Save Changes.


Step 3: Generate Your App Credentials

  1. Still on the Basic settings page, locate your App ID and App Secret keys. Copy and save both of these values, as you will need them to connect Bread & Butter in the final step.

Step 4: Complete Verifications & Publish Your App

Facebook requires manual business verification and data checkups before allowing your app to go live.

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

    Return to the Dashboard in the left menu and follow the remaining instructions to prepare and submit your app for review:

    • Business Verification: Follow the steps to officially verify your business identity. Note: Business Verification is strictly required by Facebook in order to go live.
    • App Review: Follow the steps and answer all questions required by the review team.

  2. Once approved, click Publish in the left menu, then click the Publish button to officially set your app to live mode.


Step 5: Link Your Credentials to Bread & Butter

  1. Log in to your Bread & Butter dashboard.
  2. Go to Settings in the left menu, then navigate to your Global Conversion Methods tab.
  3. Locate your Facebook connection and edit the settings to switch from Sandbox to Production Mode.
  4. Enter a custom name and description for your reference.
  5. Paste the App ID and App Secret you generated in the Facebook Developer portal.
  6. Click Save, and ensure the checkbox next to your new Facebook provider is enabled.

Final Polish: Complete Your White-Label Setup

You have successfully added your brand name to the Google consent screen! However, visitors may still see breadbutter.io     listed in the URL routing during the connection process.

To completely remove our branding and keep visitors fully within your own domain ecosystem, navigate to the Custom Auth Domain tab in your Bread & Butter settings to set up your Custom Auth Domain.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.