> For the complete documentation index, see [llms.txt](https://docs.logilica.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.logilica.com/integration/connecting-tools/circleci.md).

# CircleCI

The CircleCI connector imports your pipelines into Logilica so build performance and reliability feed into the [Build dashboard](/metrics-and-reports/build.md), and — once deployment detection is configured — the [DORA metrics](/configuration/dora-configuration.md).

## Authentication

CircleCI is a standalone connector authenticated with a CircleCI API token. Logilica uses the token to identify which account has access to each repository, then imports pipeline data for the projects that account can see. See [Connecting Tools](/integration/connecting-tools.md) for how to add the token.

{% hint style="info" %}
**CircleCI projects must be backed by GitHub or Bitbucket.** Logilica matches each connected repository to its CircleCI project using the repository's version control provider. Only projects hosted on GitHub or Bitbucket are supported.
{% endhint %}

## What's Imported

For each matched CircleCI project, Logilica imports pipelines and the work beneath them:

* **Pipelines** — named after the project and pipeline number, with a link to the pipeline in CircleCI
* **Timestamps** — created and started times, and job completion times
* **Build outcome** — whether the pipeline succeeded, failed, or was cancelled
* **Triggering actor** — the account that triggered the pipeline
* **Commit and branch** — the commit revision and branch
* **Workflows and jobs** — each job within each workflow of the pipeline

## How Logilica Maps the Data

Build outcomes are normalised so that success, failure, and cancelled results are consistent across every CI/CD platform Logilica supports.

## Good to Know

* **Kept in sync automatically.** After the initial import, Logilica refreshes this connection on a regular schedule — you don't need to re-trigger imports.
* **First import covers the last 6 months.** The initial scan imports pipelines created within the last 6 months, paging back through history until it reaches that window. Importing older history requires a configuration change by Logilica — contact support.
* **Up to 1000 pipelines per project.** Logilica imports up to roughly the most recent 1000 pipelines per project at onboarding. Future pipelines are added to the stored history as they complete.
* **GitHub or Bitbucket backend required.** A repository's CircleCI project is only discovered when the repository is hosted on GitHub or Bitbucket.
* **It feeds Build and DORA.** Imported pipelines power the [Build dashboard](/metrics-and-reports/build.md) (build frequency, reliability, speed, and recovery time) and, once [Release Detection](/configuration/release-detection.md) is configured, the [DORA metrics](/configuration/dora-configuration.md).
* **Push your own build data.** If you run builds that this connector doesn't cover, you can send them via the [Build Data Import API](/advanced/import/build-data.md).