HacknPlan integrates with Bitbucket to attach commits to work items automatically.

When a push event is received, commit messages are scanned for item references using the configured prefix (default: hnp-, for example hnp-5).

Create the integration

Open Administration -> Integrations in your project and select New in the Bitbucket panel.

You must provide:

• Bitbucket username (email does not work)
• App password

Create an app password

In Bitbucket, go to Profile settings -> App passwords -> Create app password.

Grant permissions needed for:

• account information
• repositories
• webhook management

After creation, copy the password immediately. It is shown only once.

Complete setup

After credentials are validated, choose the repository and click Connect.

Optional setting:

• Process existing commits: scans repository history for pre-existing hnp- references.

Test the integration

Push a commit that references a valid item, for example:

Integration test for task hnp-1

If processing succeeds, the commit appears in the work item Source Code tab with a link to Bitbucket.

Related documentation

• Discord integration
• Slack integration
• Google Calendar integration