JIRA <> BitBucket integration

I'm trying to integrate out Team's BitBucket repos with JIRA, following these instructions: https://confluence.atlassian.com/jiracloud/getting-started-with-bitbucket-and-jira-cloud-744720795.html

At the end of that document, a POST commit hook service is supposed to have been created automatically on each of the Team's repositories. Those should be visible in Bitbucket by choosing  Settings, then clicking Services under Integrations. In our case, nothing has been added there. Am I supposed to create those manually, and if so, how exactly? The instructions here are too generic, all I'm looking to accomplish is the advertised JIRA<>Bitbucket integration.


Then on top of Services and Webhooks, one can also configure Links. That's again in Bitbucket >  Settings >  Links under Integrations. Is that something that we have to do on top of all the above, instead, or is it obsolete? If not, what abilities does it add exactly on top of the main procedure above?

Thank you!



1 answer

0 vote

Hello Dimitri,

I've gone through the instructions and we will do some work on clarifying this process.

To answer your questions:

POST commit hook:

It's true that now you'll have to do the hook set up yourself. That's a definite update we will make to the documentation.

1. Log into Bitbucket.
2. Go to the specific repository you want to integrate with a JIRA project. You will need to repete this process for each repository.
3. Click the **Settings** cog.
4. Click **Webhooks**, then click **Add webhook**.
5. Give the webhook a clear name (I'd suggest using the JIRA project name)
6. Enter your JIRA URL. For JIAR Cloud this might be something like `myteamname.atlassian.net`.
7. Select **Choose from a full list of triggers**
8. Select the triggers you want JIRA to receive. At a minimum I'd suggest repository push, commit status, and Pull Request Created, Updated, Approved, Merged, and Declined.
9. Click **Save**.

This will allow JIRA to see your changes in Bitbucket.

## Links

If you want smart commits to work you'll have to add the JIRA link. It's pretty straight forward for JIRA:

1. Click **Links** in your Bitbucket repository settings page.
2. Click the **JIRA** button.
3. Enter your JIRA URL and project key.
4. Click **Save**.

That should link Bitbucket to JIRA and make smart commits available.

I hope this helps some. If this doesn't resolve your problem please let us know and we'll keep working through till we get it right.

I also appreciate your valuable time in opening this question.

Dan Stevens
Senior Information Experience Writer

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Jun 12, 2018 in Bitbucket

Do you use any Atlassian products for your personal projects?

After spinning my wheels trying to get organized enough to write a book for National Novel Writing Month (NaNoWriMo) I took my affinity for Atlassian products from my work life and decided to tr...

23,369 views 26 12
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you