How to create workspace-level Webhooks

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

Presently, it is not possible to create Webhooks on the workspace level using the Bitbucket Cloud UI. The UI option is currently only available on the repository level.

This knowledge base article will provide an explanation of how to create Webhooks on the workspace level.

Environment

Bitbucket Cloud

Solution

To create Webhooks on the workspace level, we can utilize the Bitbucket Cloud REST API below.

1 2 3 4 curl --request POST \ --url 'https://api.bitbucket.org/2.0/workspaces/{workspace}/hooks' \ --header 'Authorization: Bearer <access_token>' \ --header 'Accept: application/json'

In this example CURL command, we can use access tokens as an authentication option.

API Reference: Create a webhook for a workspace

Updated on March 7, 2025

Still need help?

The Atlassian Community is here for you.