X

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, the X (formerly Twitter) 1-click connection 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 X Developer portal. This allows you to generate your own credentials so buyers see your brand and logo when they click "Continue with X."

Here is how to set it up in five steps.


Step 1: Create Your X (Twitter) App

  1. Log in to the X Developer website.
  2. Create a developer account by clicking Sign up at the top right. If you already have a developer account, click Developer Portal instead.
  3. In the left menu, click on Projects & Apps > Overview.

  4. Under Standalone Apps, click Create App.

  5. Enter an App name. We highly recommend using your exact company name, as this is what will appear to users during the login process. Click Next.

Step 2: Generate Your API Keys

  1. On the next screen, you will be presented with your API Key and API Key Secret.

⚠️ Important: Copy and save both of these values immediately. You will need them to connect Bread & Butter in the final step.

  1. Once saved, click Go to Dashboard.

(Note: If you click on your app name and see an option to Apply for Elevated access, you will need to fill out the requested information to upgrade your account. You must wait for your elevated application to be accepted before moving forward.)


Step 3: Configure Authentication & Permissions

This ensures your app requests the correct data (like email addresses) from your visitors.

  1. Click on your app name (either under Standalone Apps or in the left menu).
  2. Under User Authentication settings, click Set Up.
  3. Under App Permissions, select Read.
  4. Enable the toggle to Request email address from users. (This is crucial for capturing leads!)

  5. For the Type of App, select Web App, Automated App or Bot.


Step 4: Add Your Callback & Branding URLs

  1. Scroll down to the App Info section.
  2. Under Callback URI / Redirect URI, paste the following exact link: https://api.breadbutter.io/callback   
  3. Enter your standard Website URL.
  4. Enter the exact URLs for your Terms of Service and Privacy Policy. (Note: X requires these legal links in order to allow you to request user email addresses).
  5. Click Save at the bottom of the page to lock in your app changes.

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 X 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 API Key (This goes into the Client ID field).
  6. Paste the API Key Secret (This goes into the Client Secret field).
  7. Click Save, and ensure the checkbox next to your new X provider is enabled.

⏱️ Note: It may take X up to an hour to fully approve and provision your Developer account. If your login button is not working immediately, please wait and try again later.

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.