Skip to main content
Setting up notifications in pipelines

How to configure notifications about your pipeline and any associated PRs

Brandon Chin Loy avatar
Written by Brandon Chin Loy
Updated over a week ago

For teams using Slack or Microsoft Teams, it's possible to set up notifications to stay informed about your pipeline and any of the associated PRs within it.

How does it work?

Notifications can be set up so that your team is informed of important events that happen within your pipeline and require action from a team member. These are:

  • Validations

  • Deployments

  • Merge Conflicts

You can choose to be notified about one or more of these events, and specifically what event triggers a notification.

How do I configure it?

1) When looking at your pipeline, access the settings by clicking the cog in the top right and selecting Edit pipeline details...

2) In the pop up window, select the "Notifications" tab.

3) Select the Add notification button to set up your first configuration.

You will be shown the following screen

4) Select the environment(s) that you wish to receive notifications about.

5) Choose the specific event(s) that you wish to be notified about. These can be validations only, deployments only, validations and deployments, or merge conflicts. For validations and deployments, you can choose whether to be notified about successes, failures or both.
โ€‹

6) Select whether you are using Slack or Microsoft Teams and paste in the integration URL for the specific channel you wish to receive the notifications in.

7) Enter a friendly name to identify this notification in future, for example you may want to enter the name of the channel to where the notifications will be sent.

8) Press Save Notification to save the notification and start receiving notifications

What's the result?

You will start to receive notifications based on your configuration.

Slack

Microsoft Teams

In the case of validation errors or merge conflicts, you can click your PR name in the notification and be directly linked to the PR in your pipeline.

How do I edit a notification?

1) When looking at your pipeline, access the settings by clicking the cog in the top right and selecting Edit pipeline details...

2) In the pop up window, select the "Notifications" tab.

3) Click the blue pencil icon next to the notification you wish to delete

4) Edit the notification as appropriate, see "How do I configure it?" for an explanation of the options

5) Press Save Notification to save the changes or press Back to notifications to return to the list

How do I delete a notification?

1) When looking at your pipeline, access the settings by clicking the cog in the top right and selecting Edit pipeline details...

2) In the pop up window, select the "Notifications" tab.

3) Click the red bin icon next to the notification you wish to delete

4) Press Delete notification to confirm deletion of the notification

Did this answer your question?