Connect Slack

Step 1: Create a Slack app

1. Go to the Slack API dashboard and sign in with the Slack account you want to triage.
2. Click Create New App > From scratch.
3. Name the app Leanbox and pick the workspace you want to install it into.
4. Click Create App — you'll land on the app's Basic Information page.

Step 2: Configure OAuth and redirect URL

1. In the left sidebar, open OAuth & Permissions.
2. Under Redirect URLs, click Add New Redirect URL and enter the URL where your Leanbox is hosted followed by /api/slack/callback (e.g. https://your-leanbox-domain.com/api/slack/callback).
3. Click Add, then Save URLs.

Step 3: Add scopes

Still on OAuth & Permissions, scroll down to Scopes.

Leanbox connects entirely as you — it reads what you can read and posts replies from your account. All scopes go under User Token Scopes. Leave Bot Token Scopes empty.

Under User Token Scopes, add:

• channels:history — read messages in public channels you're a member of.
• channels:read — list public channels you're a member of.
• chat:write — post replies from your account when you send a draft.
• groups:history — read messages in private channels you're a member of.
• groups:read — list private channels you're a member of.
• im:history — read your direct messages.
• im:read — list your DM conversations.
• mpim:history — read your group DMs.
• mpim:read — list your group DMs.
• users:read — resolve user names from Slack IDs.

Step 4: Grab your Client ID and Client Secret

1. In the left sidebar, click Basic Information.
2. Scroll to App Credentials.
3. Copy the Client ID and Client Secret values and store them somewhere safe.

Step 5: Connect Slack in Leanbox

1. Open Leanbox and click Connect Slack on the home page.
2. Paste your Client ID and Client Secret into the dialog.
3. Click Save & Connect — you'll be redirected to Slack.
4. Pick the workspace, then approve the requested scopes.
5. You'll land back in Leanbox with the Slack card showing a Connected status.