Skip to main content

Login with Slack

To enable Slack Auth for your project, you need to set up a Slack OAuth application and add the application credentials to your Supabase Dashboard.

Overview#

Setting up Slack logins for your application consists of 3 parts:

Steps#

Access your Slack Developer account#

  • Go to api.slack.com.
  • Click on Your Apps at the top right to log in.

Slack Developer Portal.

Find your callback URL#

The next step requires a callback URL, which looks like this:

https://<project-ref>.supabase.co/auth/v1/callback

  • Go to your Supabase Project Dashboard.
  • Click on the Settings icon at the bottom of the left sidebar.
  • Click on API in the list.
  • Under Config / URL you'll find your API URL, you can click Copy to copy it to the clipboard.
  • Now just add /auth/v1/callback to the end of that to get your full OAuth Redirect URI.

Create a Slack OAuth app#

Under Create an app...:

  • Click From scratch
  • Type the name of your app
  • Select your Slack Workspace
  • Click Create App

Under App Credentials:

  • Copy and save your newly-generated Client ID
  • Copy and save your newly-generated Client Secret
  • Click Permissions

Under Redirect URLs:

  • Click Add New Redirect URL
  • Paste your Callback URL then click Add
  • Click Save URLs

Enter your Slack credentials into your Supabase Project#

  • Go to your Supabase Project Dashboard.
  • In the left sidebar, click the Authentication icon (near the top).
  • Click Settings from the list to go to the Authentication Settings page.
  • Enter the final (hosted) URL of your app under Site URL (this is important).
  • Under External OAuth Providers turn Slack Enabled to ON.
  • Enter your API Key (client_id) and API Secret Key (client_secret) saved in the previous step.
  • Click Save.

Add login code to your client app#

The JavaScript client code is documented here: Supabase OAuth Client Code.

const { user, session, error } = await supabase.auth.signIn({
provider: 'slack',
})

Add this function which you can call from a button, link, or UI element.

async function signInWithSlack() {
const { user, session, error } = await supabase.auth.signIn({
provider: 'slack',
})
}

To log out:

async function signout() {
const { error } = await supabase.auth.signOut()
}

Resources#