Bitbucket Integration

The HourStack Bitbucket integration allows your team to schedule and track time from the issues they’re already working on in Bitbucket — which means no duplicating issues, interrupted workflows, or jumping back and forth between applications.

You can connect or disconnect integrations anytime through your account settings. All integrations are scoped to you personally, meaning that nobody else on your team can access your integration connection or data. You'll have access to your Bitbucket integration across all of your workspaces.

Other Helpful Resources:

• Scheduling With Integrations
• Manage Your Integrations

Connecting the Integration

To connect your Bitbucket account, navigate to your account settings and find Bitbucket under the available integrations and click "Connect". This will take you to Bitbucket to login to the account you'd like to connect and to authorize the HourStack app to access your Bitbucket account data. Once you've authorized the HourStack app, the integration will be connected and you can start using it immediately from your calendar.

Integration Settings

On your account settings page, click the "Manage" link next to your connected Bitbucket integration to manage the settings.

• Automatically complete issues Turn this setting on if you'd like for source Bitbucket issues to be completed in Bitbucket automatically when you complete the corresponding task in HourStack

Integration Configuration

Filtering and sorting selections you make within the integration will automatically be saved to your integration configuration so that each time you open the integration, it will be in the state you last left it, even across browsers or devices.

Bitbucket Repos

The Bitbucket integration features two primary views, the list of Bitbucket repos and the list of Bitbucket issues. To display Bitbucket issues, you must first select a Bitbucket repo as the source for the issues. The list of repos is sorted alphabetically and is sortable and searchable. You can switch the Bitbucket repo you want to source issues from anytime.

Searching Issues

Bitbucket issues are searchable by name.

Creating Tasks in HourStack

You can use Bitbucket issues to create tasks in HourStack by dragging and dropping them onto the calendar, or by clicking on the Bitbucket issue and selecting "Schedule issue" from the menu. Notes from the Bitbucket issue are automatically copied over to the HourStack task. Creating tasks from integrations requires the same permissions as creating tasks from scratch.

Accessing the Original Bitbucket Issue

Tasks in HourStack created from Bitbucket issues will remain linked. Content changes will not be synced between HourStack and Bitbucket, but from within HourStack you'll be able to directly access the Bitbucket issue from the task by clicking the Bitbucket icon, or the options dropdown when editing the task.

Manually Closing Bitbucket Issues from HourStack

There are a couple of options for manually closing Bitbucket issues from within HourStack. For automatic closing of issues when a task is completed in HourStack, see the integration settings section above.

1. From the integration sidebar, click the issue and select "Close in Bitbucket".
2. From the task itself, click the options menu and click "Close in Bitbucket".

Disconnecting the Integration

To disconnect your Bitbucket integration, navigate to your account settings and click the "Manage" link next to your connected Bitbucket integration. Click the "Disconnect" button and confirm you'd like to disconnect the integration. This will disconnect the integration from the HourStack side. To fully disconnect the integration you'll need to revoke HourStack's access under personal settings > app authorizations in Bitbucket as well.

Revoking access on the Bitbucket side is required if you want to switch to integrating with a different Bitbucket account.

Integrating with Bitbucket via the HourStack Browser Extension

With the HourStack Browser Extension you can easily schedule and track time on issues in Bitbucket whilst remaining in the web app. You can read more about how to utilize the browser extension by reading the section titled “Adding Tasks from Integrated Apps” for the following browsers:

• Google Chrome
• Firefox
• Microsoft Edge

• Connecting the Integration
• Integration Settings
• Integration Configuration
• Bitbucket Repos
• Searching Issues
• Creating Tasks in HourStack
• Accessing the Original Bitbucket Issue
• Manually Closing Bitbucket Issues from HourStack
• Disconnecting the Integration
• Integrating with Bitbucket via the HourStack Browser Extension