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. Click on Apps in the left menu, then click Create App.
  4. Enter an App name. We highly recommend using your exact company name, as this is what will appear to users during the login process.
  5. For environment, choose Production, then click Create New Client Application.
  6. Click Close on the API keys dialog.

Step 2: Configure Authentication & Permissions

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

  1. Click on your app name on the page.
  2. Beside OAuth 2.0 keys, click Edit settings.
  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 3: 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 4: Generate Your Keys

  1. Beside OAuth 1.0 keys, click Regenerate, then confirm Yes to regenerate the keys.
  2. Copy and save your Consumer Key and Consumer Key Secret for the Bread & Butter setup below.

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.