## CircleCI integration

CircleCI is a continuous integration and delivery platform that automates building, testing, and deploying software. This integration connects CircleCI to Frontegg using a Personal API Token, enabling your AI agent to manage projects, pipelines, workflows, jobs, contexts, environment variables, webhooks, schedules, and insights.

Prerequisites
- A CircleCI account
- Access to your [User Settings → Personal API Tokens](https://app.circleci.com/settings/user/tokens)


Token permissions
A Personal API Token acts on your behalf and has full read and write permissions for the organizations and projects you can access. Create the token under a user account with the access level you want the integration to have.

### Connect CircleCI

#### Step 1: Open the Personal API Tokens page

Sign in to CircleCI and navigate to **User Settings → Personal API Tokens** at `https://app.circleci.com/settings/user/tokens`. This page lists the tokens generated for your account.

Click **Create New Token**.

![CircleCI Personal API Tokens page](/assets/circleci-1.d07f1af8bdddb8857c383efa7f7426567c72ee3af1b56150bf7c64efa1a28c00.1ce25488.png)

#### Step 2: Name the token

In the **Create New API Token** dialog, enter a descriptive **Token name** such as `Frontegg Integration`. Optionally adjust the **Expiry date** (tokens can have a maximum expiry of one year), then click **Add API Token**.

![CircleCI create new API token dialog](/assets/circleci-2.6d0fb76c746fe5ee00b2c61a2f3a206fb830a375c507398023a17456da463c6b.1ce25488.png)

#### Step 3: Copy the token

CircleCI displays the new token value once. Click **Copy** to copy it, and store it securely — you will not be able to view it again after closing the dialog.

Copy the token now
CircleCI shows the full token only once, immediately after creation. Copy it before closing the dialog. If you lose it, delete the token and create a new one.

![CircleCI new API token value](/assets/circleci-3.7065183b86739400b492dea1ec41fb52b334e637a9ea7771b7e82f9d47aca74e.1ce25488.png)

### Configure the Frontegg portal

Once you have obtained your **Personal API Token** from the steps above, enter it in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to **[ENVIRONMENT]** → **Integrations** → **CircleCI**.
2. Enter the token in the **API Key** field.
3. Click **Save**.


Keep your credentials secure
Never share or commit your Personal API Token to version control.

### Additional resources

- [CircleCI API v2 documentation](https://circleci.com/docs/api/v2/)
- [Managing API tokens](https://circleci.com/docs/managing-api-tokens/)
- [CircleCI Personal API Tokens](https://app.circleci.com/settings/user/tokens)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)