PopcornTeam Admin Docs
Integrations

Slack

How to get your Slack API key and connect it to PopcornTeam Admin.

Create a Slack app, add bot scopes, install to workspace, copy the Bot User OAuth Token and Signing Secret. Set the Event Subscriptions Request URL to your webhook receiver endpoint.

Prerequisites

Steps

  1. Go to Create app on Slack API.
  2. Create a new API key / Bot Token (starts with xoxb-…) and copy it immediately — most providers show it only once.
  3. Note any additional required values: Allowed User IDs (e.g. U123,U456 (comma-separated, leave empty for all users)), Approval Channel ID (e.g. C0123456789 (where approval notifications fan out)), Spam / Default Channel ID (e.g. C0123456789 (spam reports + default flow output)).
  4. In PopcornTeam Admin, go to /agents/integrations, find Slack, and paste the values into the credential dialog.

Credential fields

FieldRequiredDescription
Bot TokenYesSecret — stored encrypted, never exposed. (e.g. xoxb-...)
Signing SecretYesSecret — stored encrypted, never exposed. (e.g. Found in Slack App > Basic Information > Signing Secret)
Allowed User IDsNostring (e.g. U123,U456 (comma-separated, leave empty for all users))
Approval Channel IDNostring (e.g. C0123456789 (where approval notifications fan out))
Spam / Default Channel IDNostring (e.g. C0123456789 (spam reports + default flow output))

Troubleshooting

  • Invalid credentials: verify the key was copied in full with no trailing spaces.
  • Key not working: check that your Slack account has API access enabled and billing is active if required.
  • Need help?: refer to the Slack documentation.

On this page