Integrate Bitbucket commits, branches, and pushes with ClickUp tasks. This allows you to:
- See all Bitbucket activity related to a task directly in ClickUp.
- Optionally receive ClickUp notifications when new Bitbucket activity items are added to tasks.
- Automatically (or manually) attach Bitbucket activity to ClickUp tasks.
- Automatically change Statuses with Bitbucket actions by adding
CU-taskID[status]
likeCU-1234[closed]
to your commits
How to Enable Bitbucket in ClickUp
Step 1 (option 1): Authorize Bitbucket.com
Note: Only admins can attach repositories to your Team's Spaces.
Click Add Bitbucket
to authorize ClickUp.
Step 1 (option 2): Authorize self-hosted Bitbucket
1. In your hosted bitbucket, go to Manage account
in the top right dropdown menu
2. Go to Personal access tokens
in the left sidebar
3. Create a new access token with admin
permissions on Projects
and Repositories
.
4. Copy the personal access token given into 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 to the right of Team Repos
. 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 CU-
in front of it.
Example: CU-12345
Manually associating Bitbucket Activity
- Click the Bitbucket icon on any task
- Select a Repo
- Select a Branch
- 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 CU-
in front of it, as well as the status you want inside brackets
Watch the task's status change in this video. Example: CU-ud5b[ready]
Note: You can also link task ID's from Bitbucket back to ClickUp!
- Go to repository settings
- Click
Links
- Add new link
- Link type:
custom
- Link URL:
app.clickup.com/t/\1
- Link key:
CU-(\w{3,10})(\[\w+\])?
This works for commits and pull requests.
Actions
Quickly and easily create new branches from within ClickUp with our quick actions.
- Click on the Bitbucket icon to open the Git modal
- On the left are a variety of auto-generated quick copy options like suggested name, command to checkout and link a new branch locally, command to link a single commit, or a command to open a pull request
You can customize the auto-generated name used in these options under the Bitbucket integration settings!
Pull requests
Now, you can create pull requests from within ClickUp or link existing ones! To create a new pull request in ClickUp:
- Click on the Bitbucket icon on the task you would like to link it to and click the "New Pull Request" button.
- In the modal, a suggested pull request title will be pre-filled with a suggested title. If you don't like the auto-generated title, you can adjust it in the Bitbucket integration settings.
- Select a target and source branch
- Enter a description
- Create the pull request
As soon as you create a pull request in ClickUp or link an existing one a link to the associated ClickUp task will be added to the pull request!
Once a pull request is linked you will be able to see who opened it, the reviewer (if one is assigned), CI/CD status, and pull request status (open, review requested, under review, merged, closed) all from within the linked ClickUp task!
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!