Skip to main content

Connecting Slack to Bicycle

Connect to Slack workspaces for messaging and notifications.

Requirements​

To follow the steps in this guide, you'll need:

  • An active Slack workspace
  • Permission to authorize apps in that workspace (administrator approval may be required)
note

Your Slack workspace administrator may need to approve the Bicycle app before you can authorize it.

Setup​

Open Connectors and select Slack

In the sidebar, go to Connectors. Under Recommended, find Slack and click + Connect.

Navigate to the Slack connector in Bicycle

Choose OAuth

Enter a connection name (for example, MySlackConnection), select OAuth as the connector method, then click Next.

Select OAuth as the connector method

Authorize in Slack

After you click Next, Bicycle opens a popup to Slack's authorization page. The main window shows Waiting for authorization... while you complete authorization in the popup.

In the popup, select the workspace you want to connect, review the requested permissions, and click Allow.

Authorize the Bicycle app in Slack

The following bot token scopes are requested automatically during OAuth:

  • app_mentions:read — View messages that mention the app
  • channels:history — View messages in public channels
  • channels:read — List public channels
  • chat:write — Send messages
  • files:read — View files
  • files:write — Upload and share files
  • groups:history — View messages in private channels
  • groups:read — List private channels
  • im:history — View direct message history
  • im:read — View direct messages
  • im:write — Start direct messages
  • reactions:write — Add emoji reactions
  • users:read — View people in the workspace

Confirm the connection

When authorization completes, the popup shows Connected Successfully! and closes automatically. Bicycle shows Connection successfully added! with the connection name, ID, and method (OAuth). Click Close to return to the Connectors page.

OAuth connection success

References​