# Connect Bitbucket Pipelines with Unblocked to analyze CI failures

URL: https://getunblocked.com/integrations/bitbucket-pipelines/

Unblocked’s CI Failure Agent analyzes failed Bitbucket Pipelines builds on your selected repositories and posts a root-cause report with a suggested fix directly to the pull request.

---

## Bitbucket Pipelines integration details

- **Category:** CI systems
- **Analyzed signals:** pipeline runs, CI failure analysis, PR triage reports
- **Supported products:** Bitbucket Pipelines
- **Delivery:** CI Failure Agent reports in pull requests and merge requests
- **Content reviewed:** July 20, 2026
- **Documentation:** <https://docs.getunblocked.com/data-sources/bitbucket-pipelines>
- **Website:** <https://bitbucket.org/product/features/pipelines>

## What the Bitbucket Pipelines integration adds

Bitbucket Pipelines supplies the build evidence needed to understand whether a pull-request failure comes from the proposed change, the test environment, or an existing dependency. Unblocked combines that evidence with repository context before posting a confidence-gated report.

Because Unblocked already understands your codebase, pull requests, and team discussions, its analysis is grounded in that context — it explains what broke and suggests a fix, with links back to the relevant code and history.

Reports are posted as a comment on the pull request and are gated by confidence. Bitbucket posts on behalf of a bot account, so you set up (or reuse) an Unblocked bot user during configuration.

### What you get

- **Automatic failure analysis** — The CI Failure Agent reads failed Bitbucket Pipelines builds and analyzes the logs to find the root cause — no manual log-digging.
- **Root-cause reports on the PR** — When confident, Unblocked posts a comment on the pull request explaining the failure and suggesting a fix.
- **Grounded in your codebase** — Analysis draws on your indexed code, pull requests, and discussions, so suggestions fit how your project actually works.
- **Confidence-gated, per-developer control** — Reports post only when Unblocked is highly confident, and each developer can toggle them for their own PRs in Personal Settings → Preferences.

## How to connect Bitbucket Pipelines to Unblocked

Prerequisites:

- An Unblocked account (free to start).
- Your Bitbucket source code connected to Unblocked — the CI Failure Agent runs on your connected repositories.
- A Bitbucket bot account to post CI reports (invited to your workspace), or an existing bot account you can reuse.

### Connect Bitbucket Pipelines to Unblocked

1. In Unblocked, open Settings → Continuous Integration and click Add CI Provider.
2. Click the Bitbucket Pipelines tile, then click Select Repositories and toggle the repositories where you want the CI Failure Agent enabled.
3. Set up a bot account: create a Bitbucket account named Unblocked, then sign in as a workspace admin and invite it to your workspace.
4. Select the bot account in Unblocked and authorize it if prompted, then click Save Settings.

See the complete setup guide, screenshots, and troubleshooting: <https://docs.getunblocked.com/data-sources/bitbucket-pipelines>

## Bitbucket Pipelines failures the agent can analyze

Examples of Bitbucket Pipelines failures the CI Failure Agent can investigate:

- "Why did the Bitbucket Pipelines build fail on this pull request?"
- "What is the root cause of the failing step in CI?"
- "Which recent change most likely caused the build failure?"

## Related integrations

- [Bitbucket](https://getunblocked.com/integrations/bitbucket/) — Repositories and pull requests from Bitbucket Cloud and Data Center — kept current as your team pushes, and cited as sources in answers.
- [GitHub Actions](https://getunblocked.com/integrations/github-actions/) — Unblocked’s CI Failure Agent analyzes failed GitHub Actions runs on your selected repositories and posts root-cause reports to the pull request.
- [GitLab Pipelines](https://getunblocked.com/integrations/gitlab-pipelines/) — The CI Failure Agent analyzes failed GitLab pipeline runs on your selected projects and posts root-cause reports to the merge request.
- [CircleCI](https://getunblocked.com/integrations/circleci/) — The CI Failure Agent watches your selected CircleCI projects via webhook, analyzes failed builds, and posts root-cause reports to the pull request.

## Get started with Unblocked

- Start a free trial: <https://getunblocked.com/dashboard/get-started>
- Pricing: <https://getunblocked.com/pricing/>
- Documentation: <https://docs.getunblocked.com/data-sources/bitbucket-pipelines>
- All integrations: <https://getunblocked.com/integrations/>