Git Integration for Jira Cloud Documentation

Contact support

Adding webhooks for Bitbucket Cloud

Pull request webhooks are now supported. See details on this page.

Supported webhook events:

  • Repository – Push
  • Pull request – Created
  • Pull request – Updated

Right click here to open this video in a new browser tab for more viewing options. (While the above video showcases other integration, jump to 01:41
to see Webhook setup for Bitbucket Cloud.)

Before you can proceed with the steps outlined on this guide, webhooks must be enabled in the Git Integration for Jira app repository configuration for your Jira instance. For more details, see Indexing triggers – Getting Started.

Setting up webhooks for Bitbucket Cloud

Configure webhook by logging in to your Bitbucket.

  1. Open a project by clicking on it.

    Click Repository Settings then under WORKFLOW, select Webhooks.

  2. Click Add webhook to create a webhook for the repository. The Add new webhook screen appears.

    • Title – This is the title name for this webhook.

    • URL – This field accepts the webhook url from your Git Integration for Jira app ➜ Webhooks setting.

    • Triggers – By default, the trigger for the webhook is a repository push. If you want different actions to trigger the webhook, click Choose from a full list of triggers. The list of all the webhook trigger event types is displayed.

      Set the necessary scope depending on your organization access/usage rules. For this guide, choose the following triggers:

      • Repository – Push (required)

      • Pull Request (optional) – select these options to also include the pull request triggers

        • Created

        • Updated

  3. Switch to your Jira instance then navigate to Manage Git repositories page and then click Indexing triggers (or alternatively go to Jira Settings ➜ Apps. On the sidebar, click Indexing triggers).

    Copy the complete secret key URL mentioned from the paragraph description below the Secret key box.

  4. Switch back to Bitbucket (where you left off) and paste this information into the provided URL box.

  5. Enter a meaningful Title name for this webhook.

  6. For the Triggers, if your organization does not require pull request events, select Repository push. Otherwise, select Choose from a full list of triggers (recommended) and then tick Repository (Push) and Pull Request (Created, Updated).

  7. Click Save to complete this setup.

Pull request webhooks

The Git Integration for Jira app supports pull request webhooks now.

For pull request triggers, you will need to have three (3) separate service hooks configuration for it to work properly. See step 9, second option for the webhook triggers.

Have feedback about this article? Did we miss something? Let us know!
On this page