Configure Bitbucket Webhooks

The following are instructions for setting up webhooks for repositories PullRequest will be used for. These steps will need to be repeated for each Bitbucket repository.

This guide assumes the PullRequest Proxy has been connected to your instance of Bitbucket Server and the PullRequest posting user has been added to the necessary repositories.

1. From the PullRequest Proxy home screen, click the Repositories tab in the left sidebar. You should see a list of all of the repositories the PullRequest posting user appropriate access to.
   
   
2. Click on a repository's Configure button. This will open a Bitbucket configuration page to create a webhook for the selected repository.
   
   
   
   
   
3. Use these options when creating the webhook:
   • The URL for your webhook should be the base URL of your Proxy with the following:

     /webhooks/bitbucket/

   • OPTIONAL - Add a webhook secret. The secret will be used to sign your webhook requests as they are posted to the proxy.
     • You will need the same webhook secret for all of your repositories if you add one.
     • Update your webhook secret in the PullRequest Proxy UI if you are adding one, otherwise the proxy will not be able to verify/process the webhooks.
       
       
   • Webhook events needed:
     • Repository:
       • PUSH
       • MODIFIED
     • Pull Request
       • ALL EVENTS
         
         
4. Click the Test connection button in the repository webhook configuration UI in Bitbucket and make sure you get a 200 status.
   • If not, it's likely that the webhook secret (if used) or URL may not be correct.
     
     
5. Make sure the webhook is set to Active at the bottom of the Bitbucket configuration page and click Create.
   
   
6. Repeat these steps for any other repositories that are in your list and have not been configured.
   
   
7. The PullRequest Proxy repositories table has a LAST WEBHOOK RECEIVED column which will update once you start getting webhooks from Bitbucket for the repository.
   • NOTE: The "test connection" hook isn't counted.

NEXT: Verify Data on PullRequest