Help Center

Slack Integration

Connect Slack to receive workspace activity notifications in your selected channel.

Before you start

  • Slack integration is available on Team plan workspaces.
  • You need workspace permission to manage integrations.
  • You can connect Slack in two ways: OAuth button (recommended) or manual incoming webhook URL.

Option A (recommended): Connect with Slack (OAuth)

Start from Slack main site (slack.com) and complete this exact flow.

Step 1: Prepare Slack channel

  1. Open your Slack workspace (or create a new test workspace).
  2. Create a target channel (example: #ouraboard_test).

Step 2: Create Slack app

  1. Open https://api.slack.com/apps.
  2. Click Create New App → From scratch.
  3. Set app name (example: Ouraboard Integrations (Test)).
  4. Select the same Slack workspace and create app.

Step 3: Configure OAuth redirect URL

  1. In Slack app, open OAuth & Permissions.
  2. Add redirect URL for your Ouraboard environment and save:
    • Example: https://api.ouraboard.app/api/integrations/slack/oauth/callback
  3. If needed, ensure incoming-webhook scope is present.

Step 4: Connect in Ouraboard

  1. Open Workspace Settings → Slack in Ouraboard.
  2. Click Connect with Slack.
  3. In Slack OAuth screen, choose the target channel and click Allow.
  4. Back in Ouraboard, confirm channel appears under Active Slack channels.
  5. Click Send test and verify message in Slack channel.

Option B: Add Slack webhook URL manually

  1. Create or open your Slack app and enable Incoming Webhooks.
  2. Create a webhook for the target channel and copy the generated URL.
  3. In Workspace Settings → Slack, fill: Channel name (display name) and Slack incoming webhook URL.
  4. Choose event types and click Connect.
  5. Use Send test to verify delivery immediately.

Select events

  • Issue created/updated
  • Status or column changed
  • Mentions or assignment updates

Save settings and use Send test to verify channel delivery.

Screenshots

Slack API Your Apps page with Create an App button
Slack API: Your Apps — starting point where you create a new app.
Slack OAuth authorization page with workspace and channel selected
Slack OAuth authorization — choose workspace and channel, then click Allow.
Slack app Incoming Webhooks page with toggle enabled
Incoming Webhooks — ensure incoming webhooks are activated for manual setup.
Slack app OAuth & Permissions page with Redirect URLs configured
OAuth & Permissions — verify Redirect URL and required scopes.

Troubleshooting

  • If OAuth shows redirect_uri did not match, ask your admin to update Slack app redirect URLs.
  • Reconnect if the app was removed from the Slack workspace.
  • Verify channel permissions for the installed app.
  • If manual webhook returns 404/410, generate a new incoming webhook URL in Slack.