Slack authentication

Slack authentication lets your users sign in with their Slack account.

Setup in the Slack dashboard

1. Go to the Slack API dashboard.
2. Create a new app (or open an existing one).
3. In OAuth & Permissions, add a redirect URL (the URL Slack sends users back to after login).
   • Use the WeWeb callback URL: the address of your app followed by /api/auth/callback/slack. The table below lists the URLs to add.
4. Copy the credentials Slack provides (for example Client ID and Client Secret).

Add one callback URL for each place where users sign in:

Where users sign in	Callback URL to add in Slack
Editor	https://<your-project>-editor.weweb.io/api/auth/callback/slack
Staging app	https://<your-project>-staging.weweb.io/api/auth/callback/slack
Published app	https://<your-project>-production.weweb.io/api/auth/callback/slack
Custom domain	https://your-domain.com/api/auth/callback/slack

Replace <your-project> with your project's WeWeb subdomain. You can see it in your browser's address bar when the editor is open, for example bright-harbor in https://bright-harbor-editor.weweb.io.

CALLBACK URL VS SUCCESS PAGE

Slack always sends users back to the callback URL, never to a page of your app. WeWeb then completes sign in and takes users to the Success Page, Error Page, or New User Page you choose in the Sign in with social provider action. Do not add the URL of these pages in Slack.

Connect Slack in WeWeb

1. In the WeWeb editor, open the Data & API tab, then open the Authentication subtab and go to SSO Providers.
2. Select Slack and turn on the Enable toggle.
3. Paste your credentials into the fields shown in WeWeb.
4. Click Save.

Test sign in

1. Add a “Continue with Slack” button in Interface.
2. Create a workflow on click and add Sign in with social provider.
3. Set:
   • Provider: slack
   • Success Page, Error Page, and (optional) New User Page
4. Preview and complete the sign-in flow.

Common pitfalls

Redirect URL mismatch

Make sure the redirect URL in Slack exactly matches the WeWeb callback URL ending with /api/auth/callback/slack (no trailing slash), not the Success Page URL you selected in WeWeb.

Slack app not installed

If sign in fails for workspace users, confirm your Slack app is installed to the workspace you are testing with.

Reference

Setting in WeWeb	Description	Where to find it in Slack
Client ID	Identifies your Slack app.	Slack app settings.
Client Secret	Used to complete the sign-in flow securely.	Slack app settings.

FAQs

Which redirect URL should I add in Slack?

Add the address of your app followed by /api/auth/callback/slack, for example https://your-domain.com/api/auth/callback/slack. Add one for each place where users sign in (editor, staging app, published app, custom domain). The URL of your Success Page is not the redirect URL.