Skip to main content

Get credentials

1

Create a Slack app

Go to api.slack.com/apps and click Create New App > From scratch. Name your app and select a development workspace.
2

Configure OAuth and permissions

Navigate to OAuth and Permissions. Under Redirect URLs, add:
Under Scopes > User Token Scopes, add openid, email, and profile.
3

Copy credentials

Go to Basic Information and copy the Client ID and Client Secret under App Credentials.
theAuth uses Slack’s OpenID Connect flow (/openid/connect/authorize), not the older identity.basic scope approach. Make sure you add User Token Scopes, not Bot Token Scopes.

Configuration

lib/theauth.ts

Scopes

Default scopes: openid email profile These are standard OIDC scopes that Slack supports. No additional User Token Scopes are needed for basic sign-in.

User data returned

The provider uses the OIDC sub claim as the user ID, which Slack documents as the same across workspaces for a given Slack user. Falls back to the https://slack.com/user_id claim if sub is absent.

OAuth overview

Generic OAuth 2.0 setup and account linking behavior.

Discord

Another workspace-based OAuth provider.

LinkedIn

Professional network OAuth using OpenID Connect.

Authentication overview

All sign-in methods available in theAuth.
Last modified on October 7, 2026