Connect CircleCI with Unblocked to analyze CI failures

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.

Need screenshots or troubleshooting?This is a concise connection summary. Follow the complete setup guide ↗

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.

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?