Integrate Bitbucket commits, branches, and pull requests 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 the ClickUp task id to your commits using this format
#{taskID}[status]
For example:#1abc2de[closed]
What you'll need
- The Bitbucket integration is available on every ClickUp plan.
- Only Workspace owners and admins can set up integrations.
- Only ClickUp admins can attach repositories to your Team's Spaces.
- Guests can't use the Bitbucket integration.
Authorize ClickUp to connect to Bitbucket
You can integrate ClickUp and Bitbucket.org or the self-hosted version Bitbucket. The authorization process is different depending on which version of Bitbucket you use.
Option 1: Authorize a Bitbucket.org account
From the App Center:
- Search for and select Bitbucket.
- Click Manage.
- Click Activate Bitbucket for Team.
- Click + Add Bitbucket.
-
Select No, I use bitbucket.com and click Link Bitbucket.
-
If you aren't logged in, you'll be prompted to log into your Bitbucket.org account
-
Review the permissions required and click Grant access
Now that you've authorized your account, proceed to the next step of attaching Bitbucket repositories to your Workspace.
Option 2: Authorize a self-hosted Bitbucket account
If you're using a self-hosted version of Bitbucket, you can authorize ClickUp by creating an HTTP access token. Learn more about Bitbucket HTTP access tokens.
From the App Center:
- Search for and select Bitbucket.
- Click Manage.
- Click Activate Bitbucket for Team
- Click + Add Bitbucket
-
Select Yes, I use a hosted version of Bitbucket then follow the next steps in Bitbucket.
-
In your hosted Bitbucket, click on your user profile avatar at the top right.
-
Select Manage account.
-
Select HTTP access tokens in the left sidebar.
-
Create a new access token with admin permissions for both Projects and Repositories.
-
Copy the HTTP access token provided.
-
Back in ClickUp, paste the copied token into the Access token field.
-
Enter your Bitbucket account details including:
-
Host url
-
Canonical Url (Optional)
-
-
Select your preferences:
-
Use hosted secret?
-
Static IP
-
-
Click Link Bitbucket.
Now that you've authorized your account, proceed to the next step to attach repositories to your Workspace.
Attach Bitbucket repositories to your Workspace
ClickUp allows multiple people to authorize Bitbucket within your Workspace, and also permits you to customize which repositories are shared with your Workspace.
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: You can only associate Bitbucket repositories where you have admin access.
Personal and team repositories
The table below explains the differences between personal and team repositories.
Repository type | Name in ClickUp | Description |
Personal | My repositories from Bitbucket | These are repositories that you personally have access to in Bitbucket. The first step in setting up our Bitbucket integration is authorizing ClickUp's access to these repos so that you can bring them into your ClickUp team's repos. |
Team | Bitbucket repositories added to ClickUp |
This is a list of all repos your team has access to in ClickUp. Repos here indicate that members of your team have authorized them to be accessed by your entire ClickUp team. Note: In order to use Bitbucket repos in ClickUp, they must be added to your ClickUp Team Repos. |
Repository connection issues
Sometimes, you might accidentally connect with the wrong Bitbucket account - or maybe there's been an issue with the connection. In this case, you can disconnect and reconnect your repos or your entire account.
This can be done at the bottom of the integrations page using the following options:
- Remove authorization for my Bitbucket repositories
- Re-authenticate Bitbucket
- Remove Bitbucket
Need to troubleshoot with a Bitbucket representative? You can request Bitbucket's customer support here.
Select Spaces to attach to your Repositories
You can customize which Spaces that repositories are attached to by expanding the dropdown 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 a ClickUp task ID in any part of the pull request title, branch name, or commit message in one of these formats:
#{task_id}
CU-{task_id}
{custom_task_id}
For example:
#1abc2de
CU-1abc2de
prefix-1
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 pull request.
To do this:
Add the ClickUp task ID in any part of the commit message, as well as the status you want inside brackets.
For example: #ud5b[ready]
Note: You can also link task IDs 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 both 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 the Bitbucket icon on the task you would like to link it to.
-
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.
Remove the Bitbucket integration
Only Workspace owners and admins can disable integrations.
To remove the integration, from the App Center:
- Search for and select Bitbucket.
- Scroll down and click Remove authorization for my Bitbucket repositories.