TopModTopMod

Docs › Connections

Connect Slack to your workspace

The Communications page in Workspace Settings, showing the Slack card with a Connect Slack button and "No Slack workspace connected".

Before you start

  • You need to be an admin. Only workspace admins and organization admins can connect Slack. If you're a member, you won't see Workspace Settings; ask an admin to connect Slack for you.
  • You need permission to install apps in your Slack workspace. If your Slack workspace requires app approval, Slack will ask a Slack admin to approve the TopMod app first.
  • Check whether your organization already has a default. If an organization admin has connected Slack in Organization Settings, every workspace uses it automatically. You only need this guide to connect a different Slack workspace for this one TopMod workspace.
  • TopMod only sends direct messages. The TopMod Slack app DMs members about mentions and other notifications. It doesn't post in channels or read your messages.
  • Each member links their own Slack account. Connecting the workspace installs the app; members then link their personal Slack account from their profile before DMs reach them.

1. Open the Communications page

  1. Make sure you're in the workspace you want to connect. Use the workspace switcher to change workspace if needed.
  2. Click Settings (the gear icon), then choose Workspace Settings.
  3. In the settings menu, under Connections, click Communications.
The Settings menu open from the gear icon, listing Organization Settings, Workspace Settings and Account Settings, with Workspace Settings highlighted.Workspace Settings with Communications highlighted under Connections in the settings menu, and the Slack and Discord cards on the Communications page.

You can also get here from Apps (the grid icon): under Communications, click Slack. If the workspace isn't connected yet, this takes you straight to the Slack card.

The Apps menu open from the grid icon, with Slack highlighted under Communications.

2. Start the Slack connection

  1. Click the Slack card to expand it. It shows "No Slack workspace connected" until Slack is connected.
  2. Click Connect Slack.

If your organization already has a default Slack connection, the card shows "Using your organization's default Slack connection." and the button reads Use a different Slack. Click it only if this workspace needs its own Slack workspace.

TopMod opens Slack in the same window. Finish the next step within 10 minutes, or the request expires.

The expanded Slack card showing "No Slack workspace connected", with the Connect Slack button highlighted.

3. Allow TopMod in Slack

  1. Sign in to Slack if asked, and check the Slack workspace shown at the top right is the one you want.
  2. Review the access TopMod is asking for: sending messages and starting direct messages as the TopMod app.
  3. Click Allow.

4. Check the connection

Slack sends you back to the Communications page, and you'll see "Connected to Slack".

  1. Check the Slack card shows your Slack workspace's name.
  2. Under the name, you'll see the date it was connected. The button changes to Disconnect.

What your team needs to do

Installing the app doesn't send anyone DMs yet. Each member, including you, links their own Slack account once:

  1. Click Settings (the gear icon), then Account Settings.
  2. Open Connections and click Connect Slack on the Slack card.
  3. Approve the request in Slack. TopMod shows "Connected your Slack account".
  4. Open Notifications in Account Settings. A Slack column now appears. Tick the notifications you want as Slack DMs, then save.

Until a workspace or the organization has Slack connected, members see "Slack isn't set up yet" and the Connect Slack button is unavailable.

The Slack card on a member's Account Settings Connections page, with the Connect Slack button highlighted and the message "Slack isn't set up yet".

Disconnect Slack

  1. Go to Workspace Settings > Communications and expand the Slack card.
  2. Click Disconnect.
  3. In "Disconnect Slack?", click Disconnect to confirm.

You'll see "Disconnected from Slack". What happens next depends on your organization:

  • If your organization has a default Slack connection, the workspace falls back to it and members keep getting DMs.
  • If it doesn't, members stop getting Slack DMs until someone reconnects.

Either way, members keep their personal Slack link, so they don't need to connect again after a reconnect.

Troubleshooting

  • You can't find Workspace Settings in the Settings menu: only admins see it. Ask a workspace admin to connect Slack, or to make you a workspace admin.
  • "Only an organization or workspace admin can connect slack": your admin role changed while the page was open. Refresh the page, or ask an admin.
  • "Could not connect to Slack — try again": you clicked Cancel in Slack, or Slack couldn't finish the install. Click Connect Slack again. If your Slack workspace needs app approval, ask a Slack admin to approve TopMod first.
  • "This connection request is invalid or has expired. Please try connecting again.": more than 10 minutes passed, or you reused an old Slack tab. Go back to Communications and click Connect Slack again.
  • "Could not start the connection": wait a minute and try again. If it keeps happening, contact TopMod support.
  • Members can't see a Slack column in Notifications: they haven't linked their own Slack account yet. Point them to "What your team needs to do" above.
  • Members linked their account but get no DMs: check they're in the Slack workspace you connected, and that they've ticked notifications in the Slack column.