Documentation
Bitbucket Setup
Step 1:
Before installing the app, go to your Bitbucket account and navigate to Settings.

Step 2:
Then, access the OAuth menu.

Step 3:
Click on the “Add Consumer” button.

Step 4:
Fill out the form with the following information:
- Name: Bitbucket App for Freshservice
- Callback URL: https://oauth.freshdev.io/auth/callback
- Select this is a private consumer

Step 5:
Select Permissions as in the image below.

Step 6:
Click on the “Save” button.

App Install
Step 1:
Navigate to Admin > Apps and click on the “Get More Apps” button.

Step 2:
Look for the “Bitbucket App for Freshservice” in the Marketplace and install the integration to your Freshservice instance by clicking on the “Buy App” button.

Step 3:
The Install settings page will open. You need to fill out the Client Key and Client Secret and click on the “Save” button.

Create a Branch
Step 1:
Navigate to a ticket and open the Bitbucket app in the sidebar.

If there’s no Branch created for this ticket. (Otherwise, go here!)
Step 2:
If there’s no Branch created for this ticket, then the app will display a Search bar to select repository to create a branch and a Create button.

Step 3:
Search for the desired Bitbucket repository from which you’ll create a new branch and Select it by clicking on it on the results dropdown.

Step 4:
Click on the “Create Branch” button.

Step 5:
You’ll be sent to Bitbucket to finish the Branch creation. Make sure to select “Other” in the type of Branch field.

Step 6:
Click on the “Create” button to finish creating the new Branch.

If there’s already a Branch created for this ticket.
Step 2:
If there’s already a branch linked to this ticket, then the app will display branch, commits and pull requests information.

Step 3:
Click on the “Add branch” button in the bottom of the app.

Step 4:
Search for the desired Bitbucket repository from which you’ll create a new branch and Select it by clicking on it on the results dropdown.

Step 5:
Click on the “Create Branch” button.

Step 6:
You’ll be sent to Bitbucket to finish the Branch creation. Make sure to select “Other” in the type of Branch field.

Step 7:
Click on the “Create” button to finish creating the new Branch.

View Branch Details Inside a Ticket
Step 1:
Navigate to a ticket and open the Bitbucket app in the sidebar.

Step 2:
If there’s already a branch created for this ticket, then the app will display branch, commits and pull requests summary information.

Step 3:
Click on the “Branches” button.

Step 4:
A modal will open up displaying information about branches linked to this ticket. Here you’ll be able to see:
- To which repository it belongs to
- Branch title
- If there’s a commit related, it will display it’s code
- If there’s a pull request for this branch, it will display it’s status
- Last modified date
- The ability to Create a Pull request for a branch

Step 5:
You can click on the repository name or branch title to easily access Bitbucket directly. Also, you can start creating a Pull Request for a selected branch by clicking on the button.

View Commit Details
Step 1:
Navigate to a ticket and open the Bitbucket app in the sidebar.

Step 2:
If there’s already a branch created for this ticket, then the app will display branch, commits and pull requests summary information.

Step 3:
Click on the “Commits” button.

Step 4:
A modal will open up displaying information about branches linked to this ticket. Here you’ll be able to see:
- The Author of the Commit
- Commit Title
- The Commit’s Message
- Last modified date
- The number of files there are for the Commit

Step 5:
You can click on the Commit title to easily access it on Bitbucket. Also, you can consult the files of the Commit.

View Pull Requests Details
Step 1:
Navigate to a ticket and open the Bitbucket app in the sidebar.

Step 2:
If there’s already a branch created for this ticket, then the app will display branch, commits and pull requests summary information.

Step 3:
Click on the “Pull Requests” button.
Step 4:
A modal will open up displaying information about Pull requests from branches linked to this ticket. Here you’ll be able to see:
- The Pull Request ID
- The Title of the Pull Request
- The Status of the Pull Request
- The Author of the Pull Request
- The Reviewer of the Pull Request
- Last modified date

Step 5:
You can easily access the Pull Request by clicking on the ID and Title of the pull request, to send you to Bitbucket directly.

