Slack

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 Slack 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 Slack Developer portal. This allows you to generate your own credentials so your audience sees your brand when they click "Continue with Slack."

Here is how to set it up in five steps.


Step 1: Create Your Slack App

  1. Log in to the Slack Developer website using your standard Slack account.
  2. Click Your Apps in the top right corner.
  3. Click Create New App and choose the option to create an app from scratch.

Step 2: Configure Your App Details

This ensures Slack correctly displays your brand and associates the app with your workspace.

  1. Enter an App Name. We highly recommend using your exact organization or company name, as this is what will appear to users during the login process.
  2. Choose your organization's Workspace from the dropdown menu.

  3. Click Create App to save your configuration.


Step 3: Add Your Callback URL & Scopes

This securely routes users back to your website after authentication.

  1. In the left menu, go to OAuth & Permissions.
  2. Under the Redirect URLs section, click to add a new URL and paste the following exact link: https://api.breadbutter.io/callback  
  3. Click Save URLs.
  4. Scroll down to the Scopes section. Under User Token Scopes, click Add an OAuth Scope. Type in openid  and choose it from the list.

Step 4: Make Your App Public & Generate Credentials

Slack requires you to activate public distribution so any user outside your workspace can log in.

  1. In the left menu, go to Manage Distribution.
  2. Under the Share Your App with Other Workspaces section, expand Remove Hard Coded Information.
  3. Check the box for "I've reviewed and removed any hard-coded information".
  4. Click the Activate Public Distribution button.
  5. In the left menu, navigate back to Basic Information.

  6. Scroll down to the App Credentials section.

⚠️ Important: Copy and save both your Client ID and your Client Secret. You will need them to connect Bread & Butter in the final step.


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 Slack 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 Client ID and Client Secret you generated in the Slack Developer portal.
  6. Click Save, and ensure the checkbox next to your new Slack 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.