OAuth Providers

We support a range of Social SSO providers and we’re always adding more. If you need a provider that isn’t currently available, please contact support so that we can add it ASAP!

To attach or edit an OAuth provider in your btn.social application:

1. Visit https://app.btn.social and log in to your account.
2. Select the application from the main dropdown or navigate to the https://app.btn.social/{APPID} URL manually.
3. Click on the Providers tab (default)
4. Click on the + Add Provider button. It’s always found at the end of the grid list.
5. In the dialog, click on the desired social provider icon from the options list.
   You may only configure a provider once per application, so already-configured providers will not be shown.
6. Copy the Callback URL value, which will be referred to as CALLBACK_URL, for use within the OAuth application.
   
   NOTE: A CALLBACK_URL always has this format:

   https://login.btn.social/{APPID}/{PROVIDER}/callback

7. Locate the Client ID and Client Secret values from the OAuth provider (detailed below) and paste them into the Credentials tab of the btn.social dialog.
8. (Optional) Navigate to the Scopes tab and select which provider-specific scopes to enable.
9. Click Save to apply changes.

You may update provider details at any time.

Amazon

Refer to Step 1 of the Login with Amazon for Websites official guide

1. Visit the Login with Amazon (LWA) Console and log in to your Amazon developer account.
2. Create a new Security Profile if you do not already have one or enable LWA for an existing Security Profile.
3. Manage the Web Settings for your Security Profile:
   1. Enter the https://login.btn.social/{APPID}/amazon/callback value within the Allowed Return URLs field.
   2. (Optional) Enter a value for the Allowed Origins field.
   3. Copy the Client ID and Client Secret values.

BitBucket

Refer to the Create a Consumer section of Use OAuth on BitBucket Cloud.

1. Log into your BitBucket account.
2. Click on your profile’s avatar in the top navigation bar.
3. Select All Workspaces from the dropdown menu.
4. Click on the Manage button for your target workspace.
5. From the sidebar, locate the Apps and Features section, and click on the OAuth Consumers navigation item.
6. Click on the Add consumer button.
7. Enter a value for the following fields:
   1. Name – a name your users will recognize.
   2. Callback URL – paste your CALLBACK_URL value.
   3. Ensure the Account > Read permission is checked.
      Otherwise you cannot access user profiles!
8. Click the Save button at the bottom of the page.
9. From the OAuth Consumers table view, click on the name of your new application to expand its details.
10. Copy the Key – this is your Client ID value.
11. Copy the Secret – this is your Client Secret value.

Discord

1. Register a developer application.
2. Click the OAuth2 navigation sidebar item.
3. Copy the Client ID and Client Secret values.
4. Locate the Redirects section and paste your CALLBACK_URL value.
5. Click the Save Changes button at the bottom of the page.

Facebook

Note: You must first register as a Facebook Developer.
Refer to the Create a Consumer application official guide.

1. Navigate to your Facebook Developer Applications.
2. Click the Create App button.
3. Select the Consumer application type and click Next.
4. Enter an App name and click Create App.
5. Click on Add Product in the sidebar, locate the Facebook Login product, and click on the Set up button.
6. From the sidebar, expand the Facebook Login product and click on the Settings item.
7. Ensure Client OAuth login and Web OAuth login are enabled.
8. Paste your CALLBACK_URL into the Valid OAuth Redirect URIs field.
9. Click the Save Changes button at the bottom of the page.
10. From the sidebar, expand the top-level Settings menu and click on the Basic item.
11. Copy the App ID – this is your Client ID value.
12. Copy the App secret – this is your Client Secret value.

GitHub

Refer to the Create an OAuth application official guide.

1. Navigate to your GitHub developer settings.
2. Click the New OAuth App button.
3. Complete all required fields:
   1. Application name – a name your users will recognize.
   2. Homepage URL – a homepage or website for your application/
   3. Authorization callback URL – paste your CALLBACK_URL value.
4. Click the Register application button.
5. Copy the Client ID value
6. Click the Generate a new client secret button and copy the new value.
7. Click the Update application button at the bottom of the page.

GitLab

Refer to the Create a user-owned application official guide.

1. Navigate to your GitLab Applications.
2. Enter a Name for your OAuth application.
3. Paste your CALLBACK_URL into the Redirect URI field.
4. Ensure the Confidential input is not checked.
5. Select the read_user scope.
   Otherwise you cannot access user profiles!
6. (Optional) Select any additional Scopes to request.
   You must keep your GitLab scopes synchronized with the Scopes tab of your btn.social dialog.
7. Click the Save Application button at the bottom of the page.

Google

Refer to the Setting up OAuth 2.0 official guide.
Or visit the Create authorization credentials documentation.

1. Navigate to the Credentials Console for your Google Cloud project.
2. Click the + Create Credentials dropdown and select the OAuth client ID option.
3. Select the Web application choice.
4. Enter a Name for your application.
5. Add your CALLBACK_URL to the Authorized redirect URIs list.
6. Click the CREATE button at the bottom of the page.
7. Copy the Client ID and Client Secret values for your btn.social dialog.

Instagram

Note: You must first register as a Facebook Developer.
Refer to the Get Started official guide.

1. Navigate to your Facebook Developer Applications.
2. To create a new application:
   1. Click the Create App button.
   2. Select the Consumer application type and click Next.
   3. Enter an App name and click Create App.
3. To add Instagram SSO to an existing Facebook application:
   1. Click on the desired application’s name or icon.
4. Wait for the application settings to load.
5. Click on Add Product in the sidebar, locate the Instagram Basic Display product, and click on its Set up button.
6. From the sidebar, expand the Instagram Basic Display product and click on the Basic Display item.
7. Copy the Instagram App ID – this is your Client ID value.
8. Copy the Instagram App Secret – this is your Client Secret value.
9. Paste your CALLBACK_URL into the Valid OAuth Redirect URIs, Deauthorize callback URL, and Data Deletion Request URL fields.
10. (Optional) Invite your Instagram account as a tester.
11. Locate the instagram_graph_user_profile scope and click on its Add to submission button.
    Otherwise you cannot access user profiles!
12. Click the Save Changes button at the bottom of the page.

LinkedIn

Note: You will need to create a LinkedIn Page for your company to complete setup.

1. Navigate to the LinkedIn Developer Portal.
2. Register a new application.
3. Complete all required fields:
   1. App name – a name your users will recognize.
   2. LinkedIn Page – the official LinkedIn Page for your company or product.
      You will need to create one if it doesn’t already exist.
   3. App logo – an image to display alongside your App name.
4. Click the Create app button at the bottom of the page.
5. You will be redirected into your new application’s Settings panel. Navigate to the Auth panel instead.
6. Copy your Client ID and Client Secret values.
7. Locate the OAuth 2.0 settings section and click on the pencil icon to edit the Authorized redirect URLs for your app field.
8. Paste your CALLBACK_URL value into the input field.
9. Click the Update button.

Slack

Refer to the Sign in with Slack official guide.

1. Navigate to your Slack Applications.
2. Click on the Create New App button and select From scratch when prompted.
3. Enter an App Name, select the desired Slack workspace, and click the Create App button.
4. Locate the App Credentials section and copy the Client ID and Client Secret values.
5. From the sidebar, click on the OAuth & Permissions item.
6. Locate the Redirect URLs section and paste your CALLBACK_URL value.
7. Click on the Save URLs button.

Snapchat

Refer to the Developing Your App official guide. Note: Your App will need to be verified before the Production values will work.

1. Navigate to the Snapchat Developer Portal.
2. Create an organization if you don’t already already have one.
   1. In the dropdown of the top left corner, select New Organization.
   2. Enter an Organization Name value.
   3. Click the Create button.
3. In your Organization’s home page, create a new Snap Kit Project.
   1. Click on New Project.
   2. Select the Snap Kit option.
   3. Enter a unique Name.
   4. Click the Create App button.
4. Within the Production environment, copy the Public OAuth 2.0 Client ID – this is your Client ID value.
5. Within the Production environment, generate and copy the Confidential OAuth 2.0 Client ID – this is your Client Secret value.
6. In the Kit sections, enable the Login Kit option.
7. Enter the CALLBACK_URL for the Redirect URI field.
8. Ensure the Display Name field is checked.
9. (Optional) Check the Bitmoji input, if desired.
   You will also need to check this within the Scopes tab of your btn.social dialog.
10. Save Changes

Twitch

Refer to the Registering Your App official guide.

1. Navigate to the Twitch Developer Console.
2. Click on the Register Your Application button.
3. Enter a Name for your application.
4. Paste your CALLBACK_URL value into the OAuth Redirect URLs field.
5. Select the Website Integration option for the Category field.
6. Click on the Create button.
7. In the Applications tab, locate your application and click on its Manage button.
8. Copy the Client ID and Client Secret values.

Twitter

Refer to the Twitter Developer Apps documentation.

1. Navigate to the Twitter Developer Console.
2. Create or locate an existing Twitter Project.
3. Within a Project Details page, locate the Apps section towards the bottom. Click on the Create App button.
4. Adjust the following fields:
   1. App permissions – select the Read option
   2. Type of App – select the Web App, Automated App or Bot option
   3. Callback URI / Redirect URL – paste the CALLBACK_URL value
   4. Website URL – enter your application’s website
5. Click the Save button at the bottom of the page.
6. Copy the Client ID and Client Secret values.