How to enable notifications from Bitbucket in Microsoft Teams?

Post Webhooks for Bitbucket provides support for Microsoft Teams notifications by allowing you to send real-time notifications to your Microsoft Teams channels whenever certain events occur in your Bitbucket repositories.

You can configure a webhook in Bitbucket to send a payload to a Microsoft Teams Incoming Webhook URL whenever a specific event, such as a code push or a pull request merge, takes place.

Microsoft Teams Incoming Webhook URL

To generate an Incoming webhook in Microsoft Teams, follow these steps:

Open Microsoft Teams and navigate to the desired channel where you want to add the Incoming webhook.
Click on the three-dot menu (ellipsis) next to the channel name and select Connectors from the menu.
On the Connectors page, search for Incoming Webhook and click on it.
Click on the Configure button and provide a name for the Incoming webhook and, optionally, upload an image or configure other settings as needed.
In case the connector wasn’t added to the particular channel before instead of the button Configure you will see the button Add. Add the connector to the channel and repeat all the steps from points 1-4.
Click on the Create button to continue and a webhook URL will be generated.
Copy this URL as it will be needed during the configuration process (follow the instruction below) and click on Done.

Post Webhooks for Bitbucket supports the old and new formats of Microsoft Teams Incoming Webhook URL.

Configuration

Once you have got the Incoming Webhook URL, you can proceed with the configuration of Microsoft Teams notifications. Configuration of Microsoft Teams notifications is available on all configuration levels:

Global Configurations for Bitbucket admins

Project Level Configurations

Repository Level Configurations

Find our application Post Webhooks on the level that suits your needs best: Global, Project, or Repository.
Click on Add webhook button in the left corner and create a new configuration.
Input generated Incoming Webhook URL to the URL field and specify all the necessary parameters (see table below).
Click on the Save button.

Below you can find a short definition of the parameters you have to specify:

Parameter	Definition
`Title`	the name of the configuration Our advice is to name something meaningful to you and your team so that it can be understood later easier
`URL`	created Microsoft Teams Incoming Webhook URL.
`Status`	`Active` checkbox should be enabled if this configuration is going to be used.
`Repository events` `Pull request events`	allows you to specify the types of events that should trigger the webhook.

The rest parameters are optional to provide flexibility and customization options.

Updated: 29 Jun 2023