How to register your own Slack OAuth app

Go to Slack Developer Program signup page and click Join the Program.

1. Click on the Your Apps button then Create New App.
2. Choose how you'd like to configure your app's scopes and settings. You can use a manifest file or start from scratch; for a simpler flow, select From scratch.
3. Add your App name and select a workspace to develop your app in, then click Create App.
4. In the Basic Information tab, copy your app's Client ID and Client Secret, as you'll need them when configuring your integration in Tenklo.

1. In the left sidebar, select the OAuth & Permissions tab and configure the following Redirect URL: https://api.tenklo.dev/oauth/callback.
2. Still in the OAuth & Permissions tab, under Scopes, add the scopes that are relevant to how you want to consume Slack's API. There are 2 types of scopes, Bot Token Scopes and User Token Scopes.

• Bot tokens represent a bot associated with an app installed in a workspace. They govern what your app can access. They will be added to Tenklo when creating a Slack integration.
• User token Scopes access user data and act on behalf of users that authorize them. They will be added to Tenklo when creating a Slack connection.

Tenklo supports automatic token refresh for Slack. To use it, enable token rotation in your app manifest:

1. In the left sidebar, go to App Manifest.
2. Set token_rotation_enabled to true under the top-level settings section:

settings:
  token_rotation_enabled: true

When enabled, Slack issues short-lived access tokens alongside refresh tokens. Tenklo automatically refreshes both the bot token and the user token before they expire — no action required on your end.

If token rotation is disabled, access tokens do not expire and Tenklo will not attempt to refresh them.

If you don't have a Slack Developer Sandbox already, head over to Slack's Developer Program dashboard and provision one to test your integration.

Follow the Quickstart.