# Connect CircleCI with Unblocked to analyze CI failures URL: https://getunblocked.com/integrations/circleci/ Unblocked’s CI Failure Agent watches your selected CircleCI projects via webhook, analyzes failed builds, and posts a root-cause report with a suggested fix directly to the pull request. --- ## CircleCI integration details - **Category:** CI systems - **Analyzed signals:** builds, CI failure analysis, PR triage reports - **Supported products:** CircleCI - **Delivery:** CI Failure Agent reports in pull requests and merge requests - **Content reviewed:** July 20, 2026 - **Documentation:** - **Website:** ## What the CircleCI integration adds CircleCI contributes failed-build signals from the projects you select. Unblocked evaluates those signals alongside the repository and pull request, giving reviewers a likely cause and suggested next step without making them reconstruct the failure from logs alone. 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. CircleCI connects with a personal API token. Unblocked automatically installs an outgoing webhook for each project you select, so it is notified when builds fail. Reports post as a comment on the pull request and are gated by confidence. ### What you get - **Webhook-driven failure analysis** — Unblocked installs an outgoing webhook per selected CircleCI project and analyzes failed builds automatically. - **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 CircleCI to Unblocked Prerequisites: - An Unblocked account (free to start). - Your source code connected to Unblocked — the CI Failure Agent runs on your connected repositories. - A CircleCI Personal API Token. ### Connect CircleCI to Unblocked 1. In Unblocked, open Settings → Continuous Integration, click Add CI Provider, and click the CircleCI tile. 2. Create a CircleCI Personal API Token and paste it into Unblocked. 3. Select the CircleCI projects to enable (add one by project slug if it is not listed); Unblocked installs an outgoing webhook per project automatically. 4. Toggle the repositories you want to enable, then click Save Settings. See the complete setup guide, screenshots, and troubleshooting: ## CircleCI failures the agent can analyze Examples of CircleCI failures the CI Failure Agent can investigate: - "Why did the CircleCI build fail on this pull request?" - "What is the root cause of the failing job in CI?" - "Which recent change most likely caused the build failure?" ## Related integrations - [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. - [Buildkite](https://getunblocked.com/integrations/buildkite/) — The CI Failure Agent reads Buildkite build logs, analyzes failures across your pipelines, and posts root-cause reports to the pull request. - [Jenkins](https://getunblocked.com/integrations/jenkins/) — The CI Failure Agent analyzes failed Jenkins builds on your connected 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. ## Get started with Unblocked - Start a free trial: - Pricing: - Documentation: - All integrations: