Atlassian Bitbucket

Atlassian Bitbucket is a Git-based source code repository hosting and version control platform that enables teams to manage code repositories, collaborate on software development, track changes, and implement code review workflows. As a distributed version control system, Bitbucket provides comprehensive capabilities for managing Git repositories, branches, commits, pull requests, and team collaboration within workspaces.

Category	Source control & CI/CD
Direction	Query source
Sign-in	Username and App Password
Query languages	SQLite
Tables	13
Query templates	30
Website	http://bitbucket.org

Before you start

Huntbase signs in to Atlassian Bitbucket with Username and App Password. Create the credential in Atlassian Bitbucket first, then keep it to hand for the Connect step.

1. In Bitbucket, select your profile in the upper-right corner of the top navigation bar, then select Account settings.
2. On the Atlassian Account page, select the Security tab, then select Create and manage API tokens.
3. Select Create API token with scopes, give the token a name and an expiry date, and select Next.
4. Select Bitbucket as the app, select read-only scopes, and select Next.
5. Review the token, select Create token, and copy it. It is displayed only once.

Permissions:

• read:user:bitbucket
• read:workspace:bitbucket
• read:repository:bitbucket
• read:pullrequest:bitbucket
• read:issue:bitbucket
• read:snippet:bitbucket
• read:webhook:bitbucket

Watch out for

• Bitbucket Cloud stopped letting you create app passwords on September 9, 2025, and disabled all remaining app passwords on June 9, 2026. Use an API token instead, even though the field is labelled App Password.

For the vendor's own instructions, see Bitbucket Cloud API token documentation.

tip

Use a dedicated, read-only credential for Huntbase where the product allows it. Huntbase only needs to read.

Connect Atlassian Bitbucket

1. Go to Connections and click New connection, or click New connection on the Atlassian Bitbucket product page.
2. On Product, pick Atlassian Bitbucket and choose the Owner.
3. On Details, give the connection a Name and, optionally, a Description.
4. On Connect, fill in the settings and credentials described below.
5. On Verify, review the summary and click Create & check.

For everything else on the setup page — saving a draft, I'll do this later, and what each check result means — see Connections.

Settings

Where your Atlassian Bitbucket lives:

Field	Required	Notes
Username	Yes	When you authenticate with an API token, this is your Atlassian account email, not your Bitbucket username. You can find it under Email Aliases on your Bitbucket Personal settings page.
Base URL	No	Leave it empty for Bitbucket Cloud. The default is https://api.bitbucket.org/2.0.

Credentials

The only Method is Username and App Password. Enter a Credential label (for example Production), then fill in:

Field	Required	Notes
App Password	Yes	Paste the API token here. Secret — not shown again after you save it.

Query it

Once connected, Atlassian Bitbucket can serve these languages in a query tab, and Scout can use it when you ask in Auto:

Language	Use it for
SQLite	SQL over the 13 tables listed below, alongside every other connected source.

Example: SQLite

List unassigned open issues in repositories — List open issues in repositories that have not been assigned to anyone.

SELECT * FROM bitbucket_my_issue WHERE assignee IS NULL AND status = 'open'

Atlassian Bitbucket ships with 30 query templates. Find them in Library › Queries — see Query templates.

What syncs automatically

Atlassian Bitbucket comes with a content pack. These queries run on a schedule on each new connection so the entities they find appear in the Activity Feed without you asking. You can turn syncing off from the connection's Synchronisation Settings card.

Query	Finds
Sync workspace members	organization, user
Sync repositories	resource, user
Sync workspaces	account

Tables

Atlassian Bitbucket adds 13 tables. Browse their columns from Schema in the query bar's ⋯ menu.

All 13 tables

Table	Contains
bitbucket_branch	BitBucket Branch.
bitbucket_branch_restriction	Branch restrictions allow you to control the actions users can perform on a single branch, branch type, or branch pattern within a repository.
bitbucket_commit	A Bitbucket commit is an operation which sends the latest changes of the source code to the repository, making these changes part of the head revision of the repository.
bitbucket_issue	Issues are used to track ideas, enhancements, tasks, or bugs for work on Bitbucket.
bitbucket_my_project	A Bitbucket project. Projects are used by teams to organize repositories.
bitbucket_my_repository	BitBucket repositories that you are associated with. BitBucket Repositories contain all of your project's files and each file's revision history.
bitbucket_my_workspace	Workspace is where you will create repositories, collaborate on your code, and organize different streams of work in your Bitbucket Cloud account.
bitbucket_project	A Bitbucket project. Projects are used by teams to organize repositories.
bitbucket_pull_request	Issues are used to track ideas, enhancements, tasks, or bugs for work on Bitbucket.
bitbucket_repository	BitBucket repositorie that you are associated with. BitBucket repositories contain all of your project's files and each file's revision history.
bitbucket_tag	Bitbucket repository tags.
bitbucket_workspace	Workspace is where you will create repositories, collaborate on your code, and organize different streams of work in your Bitbucket Cloud account.
bitbucket_workspace_member	Bitbucket workspace members are bitbucket users having access to the workspace.

Next steps

• Connections — health, credentials and settings after you connect
• Query languages — syntax, parameters and time ranges
• Chatting with Scout — ask questions without writing a query
• All integrations — the rest of the catalog