TeamCity On-Premises
 
2023.11
Get TeamCity On-Premises
  1. Managing Build Configurations
  2. Creating and Editing Build Configurations
  3. Adding Build Features
  4. Notifications

Notifications

Edit page Last modified: 16 May 2023

The Notifications build feature is responsible for sending notifications about build statuses and events to external services. Currently, the feature provides Email Notifier and Slack Notifier.

This feature adds to the functionality of user-level notifications that can be assigned to a particular user or user group, but it allows configuring notifications per build configuration. This approach does not require referencing a specific TeamCity user and works better for group notifications.

tip

To set up similar notifications for several build configurations, use a build configuration template.

Email Notifier

To configure email notifications for a build configuration:

  1. Enter a recipient email address. If you need to specify multiple addresses, enter each following address on a new line.

  2. Configure a branch filter. If it is not configured, you will receive notifications about the default branch only.

  3. Select events to watch.

tip

To customize the notification texts, you can modify notification templates.

Note that TeamCity Email Notifier relies on the SMTP server settings configured in Administration | Email Notifier.

tip

Starting with version 2023.05, you can also utilize Service Messages to send custom email messages from inside build steps.

Slack Notifier

The Slack Notifier feature relies on a Slack connection that should be preconfigured in the parent project's settings.

After configuring the connection, go to the settings of the build configuration you want to receive notifications for:

  1. In Build Features, add the Notifications feature and select Slack Notifier.

  2. Choose the created connection.

  3. Enter the ID of a channel or user who will be receiving notifications.

    tip

    Start typing the user ID, and TeamCity will autocomplete it. Alternatively, you can copy this ID from your Slack user profile options (Profile | More | Copy member ID).

  4. Select the message format. Slack Notifier does not currently support custom notification templates. You can select the verbose format to choose what information to display in notifications, or utilize Service Messages to send completely custom strings.

  5. Configure a branch filter. If it is not configured, you will receive notifications about the default branch only.

  6. Select events to watch.

tip

Watch our video tutorial on how to integrate TeamCity with Slack.

See also

User's Guide