║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║

---

title: Add Slack as a social connection description: Learn how to allow users to sign up and sign in to your Clerk app with their Slack account using OAuth.

<TutorialHero beforeYouStart={[ { title: "A Clerk app is required.", link: "/docs/getting-started/quickstart/setup-clerk", icon: "clerk", }, { title: "A Slack account is required.", link: "https://slack.com/get-started#/createnew", icon: "user-circle", }, ]} />

Enabling OAuth with Slack allows your users to sign up and sign in to your Clerk app with their Slack account.

Configure for your development instance

For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs—no other configuration is needed.

1. In the Clerk Dashboard, navigate to the SSO connections page.
2. Select Add connection and select For all users.
3. In the Choose provider dropdown, select Slack.
4. Select Add connection.

Configure for your production instance

For production instances, you must provide custom credentials.

To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for your Slack's API Platform.

<Steps> ### Enable Slack as a social connection in Clerk

1. In the Clerk Dashboard, navigate to the SSO connections page.
2. Select Add connection and select For all users.
3. In the Choose provider dropdown, select Slack.
4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
5. Save the Redirect URL somewhere secure. Keep the modal and page open.

Create a Slack app

1. In the Slack API Platform, navigate to the Your Apps page and select Create New App.
2. The Create an app modal will open. Depending on your app needs, select either From a manifest or From scratch. For more information on which to choose, refer to Slack's doc on manifests.
3. After following the respective steps for either option, you'll be redirected to the App Credentials page. Save the Client ID and Client Secret somewhere secure. Keep this page open.
4. In the sidenav, navigate to the OAuth & Permissions page.
5. Scroll down to the Redirect URLs section and select Add New Redirect URL. Paste the Redirect URL you saved from the Clerk Dashboard. Select Add, then select Save URLs.

Set the Client ID and Client Secret in the Clerk Dashboard

<Include src="_partials/authentication/social-connections/set-client-id-secret" />

Test your connection

<Include src="_partials/authentication/social-connections/test-your-connection" /> </Steps>

║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║