Skip to main content
Skip table of contents

How to create a new webhook?

To start the Post Webhooks for Bitbucket plugin and enable seamless integration between Bitbucket and other systems or services you have to add a new webhook.

Сreating a new webhook is available on all configuration levels:

Global Configurations for Bitbucket admins

Project Level Configurations

Repository Level Configurations

Repository configurations by default overrides project and global configurations, and project configurations by default override global settings. But this parameter is configurable in the repository and project settings.

  1. Find our application Post Webhooks on the level that suits your needs best: Global, Project, or Repository.

  2. Click on Add webhook button in the left corner and create a new configuration.

  3. After you have specified all the necessary parameters click on the Save button.

On the Configurations tab of Global Configurations, you can see all webhooks created on the repository and project levels. On Global level you can set up only 1 webhook.

Below you can find a short definition of each parameter 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

Override the global configuration

the project-level settings will override the global settings for that particular webhook.

Avaible only for Project Level Configurations.

Override the project and global configuration

the repository-level settings will override the project and global settings for that particular webhook.

Avaible only for Repository Level Configurations.

URL

resourse where the data should be sent. Also you have to specify the HTTP method to be used when making requests to the target URL:

  • POST;

  • PUT;

  • GET.

Skip URL Validation

by enabling this parameter the app will allow you to use URLs that may not conform to the standard validation rules

Enable Authentication

the app adds an authentication mechanism to the webhook requests, ensuring that only authorized parties can access the webhook endpoint. By enabling this option you have to specify folowing parameters:

  • Authentication type - the type of authentication to be used when sending requests to the webhook URL: Basic, Bearer or Kerberos authentication.

  • Username - corresponds to the user or service account that has the necessary permissions to access the webhook endpoint.

  • Password - correct password associated with the authentication mechanism you are using.

Enable Mutual TLS

enabling mutual TLS ensures that only trusted clients with valid and verified certificates can establish a connection with the webhook endpoint. By enabling this option you have to specify folowing parameters:

  • Path to Key Store - contains the private key and the associated certificate used for Mutual TLS authentication.

  • Path to Trust Store - contains trusted certificates used to verify the authenticity of other parties during Mutual TLS authentication.

  • Key Store Password - the password required to access the Key Store file.

  • Trust Store Password - password needed to access the Trust Store file.

Skip SSL Certificate Validation

this parameter instructs the app to skip the validation of SSL certificates, allowing the connection to be established even if the certificate cannot be verified.

Trigger Azure DevOps pipeline

allows you to specify the Azure DevOps pipeline that should be triggered when the webhook event occurs. By enabling this option additionality you have to specify folowing parameters:

Committers to ignore

the comma-separated list of Bitbucket user names that should NOT trigger an event. This is often used to ignore pushes from your continuous integration user.

Important: not display names, but usernames. For instance, jenkins-user.

Repository pattern

a pattern or regular expression that defines the repositories for which the webhook should be triggered. Commits on these repositories will trigger this hook.

For instance, .*-Jenkins

Avaible only for Global and Project Levels Configurations.

From branches to consider

the comma-separated list of Bitbucket branch regular expressions that should be considered when filtering events.

For instance, release/*, tag/*, etc.

Destination branches to consider

the comma-separated list of Bitbucket branch regular expressions should be considered when filtering events for pull requests only.

From branches to ignore

the comma-separated list of Bitbucket branch regexes that should be ignored.

Destination branches to ignore

the comma-separated list of Bitbucket branch regexes that should be ignored.

Status

Active checkbox should be enabled if this configuration is going to be used.

Skip CI

lets skip triggering events for commits/pull requests that include the [skip ci] or [ci skip] keywords in their title or description.

File path pattern

comma-separated list of file paths, only commits on these file paths will trigger the webhook.

For example, src/java/.*/src/main/resources/.*properties will trigger events only for the changes in the properties files.

Skip personal

skipping of the events from personal projects and repositories.

Include projects

comma-separated list of Bitbucket project keys that will trigger this event.

Avaible only for Global Level Configurations.

Exclude projects

comma-separated list of Bitbucket project keys that will be IGNORED for this event. This could be used with the combination of Include projects empty (include all).

Avaible only for Global Level Configurations.

Include repositories

comma-separated list of Bitbucket repository keys that will trigger this event.

Avaible only for Project Level Configurations.

Exclude repositories

comma-separated list of Bitbucket repository keys that will be IGNORED for this event. This could be used with the combination of Include repositories empty (include all).

Avaible only for Project Level Configurations.

Repository events

allows you to specify the types of events that should trigger the webhook.

Pull request events

A table of created webhooks provides a centralized view of all webhooks configured across your Bitbucket instance. It allows you to see the complete list of webhooks in one place, making it easier to manage and monitor them.


How to set up Azure DevOps Pipeline triggering from Bitbucket Server?

How to enable notifications from Bitbucket in Microsoft Teams?

How to integrate Bitbucket Server with Jenkins Pipelines?

Updated:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.