Summary

When creating webhooks, you might come across an error message stating that you are unable to create webhooks due to the hook limit being exceeded.

Environment

Bitbucket Cloud.

Diagnosis

When creating a webhook, you may see an error message like such:

API response:

Hook limit exceeded.

UI response/Integrations:

Unable to create Webhook at this time.

Cause

The root cause of this problem is that Bitbucket Cloud has a 50 webhooks limit by default on every Bitbucket Cloud workspace. 

You can verify if you are affected by this problem by navigating to the repository where you are trying to create webhooks > Repository Settings > Webhooks and confirm if there are more than 50 webhooks created.

Solution

This limitation is in place to avoid malicious actors from creating too many webhooks, which would affect the performance of the platform.

• 50 is an exceedingly high number of webhooks, and as such, it's very possible that you have some old webhooks that are no longer in use, if you hit this limitation. Please review your existing webhooks on Repository Settings > Webhooks, and confirm if you are able to remove any of the existing webhooks that are no longer in use.
  
  
•  If you really need more than 50 webhooks, the Bitbucket Cloud support team can analyze your use case and increase this limit for your workspace as an exception.
  → If you are on the Standard or Premium plans, contact support at https://support.atlassian.com/. The support team will help you remove this limitation.
  → If you are on the Free plan, you will have to upgrade to either the Standard or Premium plans to have this limit increased by the support team for you.