

Amazon CodeCatalyst is no longer open to new customers. Existing customers can continue to use the service as normal. For more information, see [How to migrate from CodeCatalyst](migration.md).

# Sending Slack and email notifications from CodeCatalyst
<a name="notifications-manage"></a>

You can configure CodeCatalyst to send notifications about events that occur in your project. CodeCatalyst can send notifications to messaging clients such as Slack channels. Having CodeCatalyst send messages to Slack channels helps to ensure that your entire team is aware of important events, such as workflow failures. Optionally, you can choose to have CodeCatalyst @mention you in the Slack messages it sends out so that you receive a corresponding direct message (DM).

CodeCatalyst can also send notifications directly to you in an email. Email notifications will be sent about events in any project where you are a member. These emails will be sent to the email address configured in your AWS Builder ID.

**Note**  
The events that can be sent to Slack channels can be different from those sent by email. 

**Topics**
+ [Configuring email notifications](notifications-personal.md)
+ [Sending notifications to Slack channels](notifications-projects.md)
+ [Configuring Slack direct messages](notifications-personal-slack.md)
+ [Editing notifications for a notification channel](notifications-edit.md)
+ [Removing a channel](notifications-remove-channel.md)

# Configuring email notifications
<a name="notifications-personal"></a>

You can choose to have email notifications sent to you about events in any project where you are a member. These emails will be sent to the email address configured in your AWS Builder ID. By default, you will receive emails about all project events for which emails can be sent.<a name="notifications-personal-email"></a>

**To configure email notifications for project events**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. In the top menu bar, choose your profile badge, and then choose **My settings**. The CodeCatalyst **My settings** page opens.
**Tip**  
You can also find your user profile by going to the members page for a project or space and choosing your name from the members list.

1. In **Email notifications**, find the project in the list where you want to configure email notifications, and choose **Edit**.

1. Select the events for which you want to receive emails, and then choose **Save**.

# Sending notifications to Slack channels
<a name="notifications-projects"></a>

You can configure CodeCatalyst to send notifications about project events to your team's Slack channels. By doing this, you can help ensure that your entire team is aware of important events, such as when a workflow run fails.

**Note**  
Any member of a project can manage notifications sent to channels for that project. However, only users with the **Space administrator** role can add or delete Slack workspaces. 

Use the following instructions to add a Slack channel to which notifications will be sent.

**To add a Slack channel for notifications**

1. If you're adding your first Slack channel, see instead [Getting started with Slack notifications](getting-started-notifications.md).

   After setting up your first channel, return to this procedure to set up additional channels.

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your project.

1. In the navigation pane, choose **Project settings**.

1. Choose the **Notifications** tab.

1. Choose **Add channel**.

1. Choose **Choose workspace**, and then select the Slack workspace that contains the channel where you want to send notifications.

   If your Slack workspace is not in the list, you can add it by following the instructions in [Getting started with Slack notifications](getting-started-notifications.md).

1. Before entering a **Channel ID**, if the Slack channel you want to add is private, complete these steps:

   1. In your Slack channel’s message box, enter **@aws** and choose **aws app** from the pop-up.

   1. Press Enter.

      A Slackbot message appears, indicating that Amazon Q Developer in chat applications is not in the private channel. 

   1. Choose **Invite Them** to invite Amazon Q Developer in chat applications to the channel.

1. In CodeCatalyst's **Channel ID** field, enter the Slack channel ID. To find the ID, go to Slack, and in the navigation pane, right-click the channel and choose **Open channel details**.

   The channel ID is displayed at the bottom of the dialog box. 

1. In **Channel name**, enter a name. We recommend using the Slack channel name.

1. In **Select notification events**, choose the type of event you want to receive notifications for.

1. Choose **Add**.

# Configuring Slack direct messages
<a name="notifications-personal-slack"></a>

If a CodeCatalyst project has been configured to [send notifications to a Slack channel](notifications-projects.md), those notifications can also be sent as direct messages (DMs). Having notifications sent to you directly as DMs can help raise awareness of events happening in the projects where you have a role. To enable DMs, you must add your Slack member ID to CodeCatalyst. 

**To configure Slack direct messages**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. In the top menu bar, choose your profile badge, and then choose **My settings**. The CodeCatalyst **My settings** page opens.
**Tip**  
You can also find your user profile by going to the members page for a project or space and choosing your name from the members list.

1. In **Personal Slack notifications**, choose **Connect Slack ID**, and then choose **Connect to Slack workspace**. A separate window will open.
**Tip**  
This option is not configurable unless a user with the **Space administrator** role has added a Slack workspace for your CodeCatalyst space. For more information, see [Getting started with Slack notifications](getting-started-notifications.md) and [Sending notifications to Slack channels](notifications-projects.md).

1. In the permissions request window, make sure that the name of the workspace matches the Slack workspace configured for the CodeCatalyst space. Choose **Allow** to allow Amazon Q Developer in chat applications access to the workspace. The window will close, and the Slack workspace will show the **Connnection status** as **Connected**.
**Tip**  
If the connection status does not change, check to see if an error occurred connecting the Slack workspace. You might have to scroll up to see the error. 

1. To stop receiving personal Slack notifications, choose the connected Slack workspace, and then choose **Disconnect Slack ID**.

# Editing notifications for a notification channel
<a name="notifications-edit"></a>

You can change which channels notifications go to, and you can turn off specific notifications altogether.

**To edit notifications**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your project.

1. In the navigation pane, choose **Project settings**.

1. Choose the **Notifications** tab.

1. Choose **Edit notifications**.

1. Do one of the following:
   + To send a notification to a specific channel, choose the channel from the drop-down list.
   + To turn off a notification globally, choose the toggle next to the notification.
   + To stop sending a notification to a specific channel, choose the **X** on the channel.

1. Choose **Save**.

# Removing a channel
<a name="notifications-remove-channel"></a>

You can remove a Slack channel from Amazon CodeCatalyst. By removing a Slack channel, notifications about a chosen CodeCatalyst project will no longer be sent to the channel. 

**To remove a channel**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your project. In the navigation pane, choose **Project settings**.

1. On the **Project settings** page, choose the **Notifications** tab.

1. Choose the indicator next to the channel you want to remove and then choose **Remove channel**. Choose **Ok** in the confirmation window.