> For the complete documentation index, see [llms.txt](https://knowledgebase.autorabit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.autorabit.com/product-guides/arm-1/arm-features/webhooks/configuring-a-webhook-in-bitbucket-enterprise.md).

# Bitbucket Enterprise

{% hint style="info" %}
As of 9 September 2025, app username and passwords have been deprecated as a type of authentication method. However, as of 9 June 2026, all existing app passwords will be disabled. Users are required to create API tokens and migrate this function prior to the deadline to avoid disruptions: <https://support.atlassian.com/bitbucket-cloud/docs/api-tokens/>.
{% endhint %}

{% hint style="info" %}
After the 25.3.9 release, the structure of the webhook payload URL was updated. Customers need to update the webhook URL in the repository settings of their remote repo. Some customers are still using the old webhook URL containing **autorabitrest**, which should now be replaced with api.

Example:

Old URL: [https://na25.autorabit.com/**autorabitrest/**&#x77;ebhook/triggerSCMPushrequest](https://na25.autorabit.com/autorabitrest/webhook/triggerSCMPushrequest)

Updated URL: [https://na25.autorabit.com/api/webhook/v2/\<OrgName>/trigger-scm-push-request](https://na25.autorabit.com/api/webhook/v2/<OrgName>/trigger-scm-push-request)

Unless you update the Payload URL, you might face pull request/trigger build-on-commit jobs triggering.
{% endhint %}

## A. Create a Webhook API Token in ARM

1. Log in to ARM.
2. Navigate to **Admin Section > API Token**.
3. Click **Create API Token**.

<figure><img src="/files/O2hVHe6ytK69MXUW8zp5" alt="Create API Token screen in ARM"><figcaption></figcaption></figure>

4. Enter a **Token Name**.
5. Select **Type** as **webhook**.
6. (Optional) Add a **Description**.
7. Click **Create Option**.

<figure><img src="/files/8tj5jeH81Az7F4dOJfak" alt="Webhook token details input screen in ARM"><figcaption></figcaption></figure>

8. Your webhook API token is now created.

***

## B. Create a Webhook with Authentication in Bitbucket

1. Log in to your **Bitbucket** account and open the target repository.
2. Go to **Settings** and select [**Webhooks**](https://knowledgebase.autorabit.com/product-guides/codescan/codescan-integration/webhooks).

<figure><img src="/files/6y919tGJJmP5YzJ4tOBB" alt="Bitbucket Webhooks configuration section"><figcaption></figcaption></figure>

3. In the webhook configuration form, use the following URL formats:
   * For SCM push events:

     ```
     https://login.autorabit.com/api/webhook/v2/<orgname>/enterprise/trigger-scm-push-request
     ```
   * For ALM commit syncs:

     ```
     https://login.autorabit.com/api/webhook/v2/<orgname>/enterprise/sync-alm-commits
     ```
4. Enter the webhook details and click **Save**.

***

## Smart Commits

Configure commit message patterns that associate commits with ALM stories.\
Example:

<figure><img src="/files/GqC3RPdSr5yAqO6PD2F4" alt="Smart commit example and configuration options" width="563"><figcaption></figcaption></figure>

To configure a webhook:

* Enable the **auto update on webhook** checkbox to display the webhook URL.
* For setup in other repository types, refer to the [Webhook Guide](file://product-guides/arm/arm-features/webhooks).
* To integrate with external smart commit systems, see the [Version Control Repositories Summary](file://product-guides/arm/arm-features/version-control/introduction-to-version-control/version-control-repositories-summary).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://knowledgebase.autorabit.com/product-guides/arm-1/arm-features/webhooks/configuring-a-webhook-in-bitbucket-enterprise.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.