Skip to content
  • There are no suggestions because the search field is empty.

How do I integrate with Slack?

This article describes how to set up the Slack integration so you can receive security scan notifications and vulnerability alerts directly in your Slack workspace.

⚠️ Caution: You must have Slack workspace administrator privileges to set up this integration.

Before setting up the integration, you will need the following from Slack:

  • Channel ID: The unique identifier for the Slack channel where you want to receive notifications. You can find this in your Slack channel URL. For example, in the URL https://mycompany.slack.com/messages/ABC123, the channel ID is ABC123.
  • Bot User OAuth Token: An API token generated when you create a bot app in Slack. You will create this during the setup process below.

Step 1: Create a bot app in Slack

  1. Go to https://api.slack.com/apps.
  2. Click Create New App.
  3. Select From Scratch.
  4. Enter an App name, e.g., "Holm Security Alerts".
  5. Select your workspace from the dropdown.
  6. Click Create App.

Step 2: Configure app permissions

  1. On the left sidebar, click OAuth & Permissions.
  2. Scroll down to the Scopes section.
  3. Under Bot Token Scopes, click Add an OAuth Scope.
  4. Select chat:write from the list.
  5. At the top of the page, click Install to Workspace (or Reinstall to Workspace if already installed).
  6. Click Allow to authorise the app.

Step 3: Copy your Bot User OAuth Token

After installing the app, your Bot User OAuth Token will appear at the top of the OAuth & Permissions page.

  1. Copy the Bot User OAuth Token (it starts with xoxb-).
  2. Keep this token secure and do not share it.

Step 4: Invite the bot to your Slack channel

  1. In Slack, open the channel where you want to receive notifications.
  2. Click Details in the top-right corner.
  3. Go to the Members section.
  4. Click Add members.
  5. Search for and select your bot app, e.g., "Holm Security Alerts".

💡 Tip: If you don't see your bot in the member list, make sure you successfully installed the app in Step 2.

Step 5: Set up the integration in Security Center

  1. Log in to Security Center.
  2. Click the Menu icon in the top-right corner.
  3. Click Integrations.
  4. Check Enable Slack.
  5. Click Configure to set up the integration:
    • Channel ID — the channel ID identified in the requirements above.
    • API Token — the Bot User OAuth Token copied from Slack.
  6. Click Send test message.
  7. Click Update settings.
  8. Done!

Troubleshooting

Using Bot Tokens

If you are using the new Bot Token, you may need to configure additional permissions. See the related article for more information:

How do I configure the Bot Token?

Bot not receiving messages

If the integration is enabled but you are not receiving notifications, verify the following:

  • The bot has been invited to the channel (see Step 4).
  • The chat:write permission is enabled in the Slack app settings.
  • Notification types are enabled in Security Center (see Step 5).

For more information, please contact our customer support.