---
title: "Get started with Crucible Review Hook for Bitbucket"
canonical: "https://support.appfire.com/space/CRU/149389339/Get%20started%20with%20Crucible%20Review%20Hook%20for%20Bitbucket"
format: markdown
---
> Macro (aura-html)

## Initial Setup

For the plugin to work correctly, the following must be set up:

1. Setup the Crucible Application link with Bitbucket. Instructions can be found [here](https://confluence.atlassian.com/fisheye/linking-to-another-application-385321667.html).
2. Add the repository to FishEye/Crucible for indexing. Instructions can be found [here](https://confluence.atlassian.com/crucible/setting-up-a-git-repository-in-crucible-298977505.html).
3. Enable the hook in the “Hooks” section in the settings for the desired repository.

You're now ready to get started!

## Configuration

The plugin has the following settings which must be configured per **repository**.

| Option | Description |
| --- | --- |
| Plugin Enabled | Check this box to show Crucible integration controls in pull requests for this repository. |
| Hook Enabled | Check this box to enable the Crucible MergeHook for pull requests in this repository. |
| Review Project | The Crucible Review project to be created under. |
| Use Bitbucket Reviewers | Create Crucible reviews using the reviewers defined in Bitbucket pull request. |
| Repository Name | The name of the repository in Crucible. This is to match the repository in Bitbucket to the repository in Crucible if they don't share the same name. |
| Automatically Create Reviews | Whether to automatically create reviews in Crucible. The review project specified here will be used. |
| Merge Hook Branch Regex | All branches that match this regex will have a review created when another tries to merge any changes to them through a PullRequest. |

## Adding / Editing Reviews

Crucible reviews can be created one of two ways:

1. Automatically through the plugin.
2. By hand through the Pull Request dropdown using either the **Create Review** or **Assign Existing Review** buttons.

![image](media://3bf4bc0c-b662-45c6-a01e-0b201e7d2891)

After review is assigned, you can change it in **Edit Review** dialog, which allows you to change id assigned review or unlink review from current pull request with **Unlink** button.

## Automatically Creating Reviews

Automatic review creating can be enabled by going to the repository settings page:

![image](media://fa784b1c-3b99-4882-bd11-feca4b909e75)


Automatically creating the reviews will fail if the pull-request author does not have the correct permissions in Crucible. Make sure to have the Crucible administrator check the following permissions:

- The user is listed as a Allowed review participant in the project settings.

![image]()

- Authors have permission to Edit Review Details in the permission schemes.

![image]()

## Initial authentication for new users

When new user creates Pull Request error below will display

![image](media://d05c4e40-b09f-4911-a0be-75bc3ab4e2ab)

To finish authentication procedure click suggested link. Link should be like:

```
http://localhost:7990/bitbucket/plugins/servlet/applinks/oauth/login-dance/authorize?applicationLinkID=138d700e-5b3d-319c-868a-61b9f9d37bb7
```