Bitbucket

Integrate Bitbucket commits, branches, and pushes with ClickUp tasks. This allows users to: 

1. See all Bitbucket activity related to a task directly in ClickUp. 
2. Optionally receive ClickUp notifications when new Bitbucket activity items are added to tasks.
3. Automatically (or manually) attach Bitbucket activity to ClickUp tasks. 
4. Automatically change Statuses with Bitbucket actions by adding #taskID[status]  like #1234[closed]  to your commits

How to Enable Bitbucket in ClickUp 

Step 1: Authorize Bitbucket.com 

Note: Only admins can attach repositories to your Team's Spaces. 

Click Add Bitbucket  to authorize ClickUp.

Step 2: Attach Personal Repositories to Team Repositories 

ClickUp allows multiple people to authorize Bitbucket within your Team, and also permits you to customize which repositories are shared with your Team. 

This means that you can authorize your personal account without attaching all of your repositories; you can customize which ones to attach. 

Attaching a repository does not give users access to your repository's codebase in anyway. It simply allows users to attach history items for that repository to the Space(s) you specify. 

Note: At this time, you can only associate Bitbucket repositories where you have admin access.

Step 3: Select which Spaces are attached to your Repositories 

You can customize which Spaces that repositories are attached to by expanding the drop-down on the right side of the Team Repos . Select one or more Spaces to attach repositories to. 

In order to attach Bitbucket items to tasks, the Space must be attached to the repository.

Automatically associate Bitbucket activity in ClickUp 

ClickUp will automatically pick up any new activity and associate it with tasks. To enable this, you must: 

Add the ClickUp task ID in any part of the commit message with a hashtag in front of it.

Example: #12345

Manually associating Bitbucket Activity

1. Click the Bitbucket icon on any task
2. Select a Repo
3. Select a Branch
4. Attach your commit

Automatically change task Status via Bitbucket 

You can also change the status of a task from a commit or merge request . To do this:

Add the ClickUp task ID in any part of the commit message with a hashtag in front of it, as well as the status you want inside brackets

Watch the task's status change in this video. Example: #ud5b[ready]

Note: You can also link task ID's from Bitbucket back to ClickUp!

1. Go to repository settings
2. Click Links 
3. Add new link
4. Link type: custom 
5. Link URL: app.clickup.com/t/\1 
6. Link key: #(\w{3,10})(\[\w+\])? 

This works for commits and pull requests.

Coming Soon: Actions

Soon, you’ll be able to perform Git actions directly inside of ClickUp.

Do you ever need to create a new feature branch? With Actions, you’ll be able to click to branch off and associate the branch and future commits to a ClickUp task automatically.

Having trouble with Bitbucket?

Read our troubleshooting doc or ask Bitbucket customer support here.

Be sure to let us know what else you would like to see on our feedback board here!