# Overview of Notifications Feature

Notifications are an essential part of the BountyHub platform, designed to keep users informed about important events and updates related to their security testing activities. The notifications feature allows users to receive alerts through various channels, ensuring they stay updated on critical interactions and findings.

# Key Features

  • Multiple Notification Channels: Users can choose to receive notifications via email, discord webhooks, or slack, providing flexibility in how they stay informed.
  • Customizable Notification Settings: Users can configure their notification preferences, including the types of events they want to be notified about and the frequency of notifications.
  • Real-Time Alerts: Notifications are sent in real-time, ensuring users are promptly informed about important events.
  • Integration with BountyHub Features: The notifications feature is integrated with other BountyHub features, such as Bhlast servers and payloads, allowing users to receive alerts related to their specific activities.

Let's dive deeper into the notifications feature.

# How it Works

The notifications feature is designed to provide users with timely alerts about important events. Users can configure their notification settings to specify which events they want to be notified about and through which channels.

When a significant event occurs, such as an interaction with a Bhlast server or a workflow event, such as artifact diff occurs, the system generates a notification. This notification is then sent to the user through their chosen channels, ensuring they receive the information promptly.

All notifications are defined on your profile. Then, you can choose which channel should be installed on specific features, such as Bhlast servers or workflows.

If you need to modify the notification settings, you do it on your profile. New auth parameters will be propagated to all notification installations, so you don't have to worry about updating each installation separately.

# Configuring Notifications

To configure notifications, users can navigate to their profile page.

# Notification Channels

  • Email Notifications: Users can opt to receive email notifications for important events. They need to provide a valid email address and verify it to start receiving alerts.
  • Discord Webhooks: Users can set up Discord webhooks to receive notifications in their Discord channels. They need to provide the webhook URL and configure the desired settings.
  • Slack: Users can integrate Slack to receive notifications in their Slack channels. They need to authorize the BountyHub app to access their Slack workspace and configure the notification settings.

# Slack

Slack notifications are based on the BountyHub App. To register the app, you should follow these steps:

  1. Visit your profile. Under Notifications section, you can see Add BountyBot to Slack.
  2. Click on the Add BountyBot to Slack button. The dialog box should open up, asking you to enter the name. The name is human-readable name you want to assign to the slack installation.
  3. Once you picked the name, you should be redirected to slack.
  4. Pick the workspace you want to install the Slack app on.
  5. Once you confirm, you will be redirected back to BountyHub.
  6. After it, you should see the slack installation on your profile.

The important thing to point out is that application is being configured with following permissions:

  • chat:write
  • chat:write.public

# Discord

Discord notifications are delivered using integrations and webhook URLs. This is the easiest way for users to configure their Discord integration with only few clicks.

To register it, you should:

  1. Visit your discord server.
  2. Click on the gear icon, or right-click on the channel, then Edit Channel.
  3. Go to Integrations > Webhooks > New Webhook
  4. Once created, click on Copy Webhook URL.
  5. Go to BountyHub's Profile page under
  6. Click on Add BountyBot to Discord.
  7. Enter the name and the webhook URL, and that is it.

Note that discord webhook URL is unique per profile. The reason is that you can assign the same Discord reference to many things, but there is no good reason why you want to install the same integration multiple times.

# Email

These are e-mail addresses that you can use to be notified on, and can be different from your primary e-mail address. Primary e-mail address is only used for profile related actions, such as password reset etc.

On the other hand, notification e-mails are only used, so you can be notified about events. You can duplicate your primary e-mail address.

You cannot use it to sign in or any other profile related action.