> ## Documentation Index
> Fetch the complete documentation index at: https://infisical.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CircleCI connection

> Learn how to configure a CircleCI Connection for Infisical.

Infisical supports the use of [API Tokens](https://app.circleci.com/settings/user/tokens) to connect with CircleCI.

> [!NOTE]
>
> CircleCI requires the account user to have Read/Write or Admin permissions

## Create a CircleCI API token

**1. Click the profile image in the top-right corner and select 'User Settings'**

![Dashboard Page](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/circleci/circleci-dashboard.png)

**2. In the user settings sidebar, select 'Personal API Tokens'**

Click the "**Create new token**" button to create a new personal API token.

![User Settings Page](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/circleci/circleci-settings.png)

**3. Set a name for the token and click 'Add API Token'**

After creating the token, save the shown token value as it won't be shown again.
You'll need this token to configure your Infisical connection

![Api Keys Page](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/circleci/circleci-create-new-token.png)

## Create a CircleCI connection in Infisical

> [tab] Infisical UI
>
> **1. Navigate to App Connections**
>
> In your Infisical dashboard, navigate to the **Integrations** tab in the desired project, then select **App Connections**.
>
> ![App Connections Tab](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/general/add-connection.png)
>
> **2. Select CircleCI Connection**
>
> Click **+ Add Connection** and choose **CircleCI Connection** from the list of integrations.
>
> ![Select CircleCI Connection](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/circleci/circleci-app-connection-option.png)
>
> **3. Fill out the CircleCI Connection form**
>
> Complete the form by providing:
>
> * A descriptive name for the connection
> * An optional description
> * The API Token value from the previous step
>
>   ![CircleCI Connection Modal](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/circleci/circleci-app-connection-form.png)
>
> **4. Connection created**
>
> After submitting the form, your **CircleCI Connection** will be successfully created and ready to use with your Infisical project.
>
> ![CircleCI Connection Created](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/circleci/circleci-app-connection-generated.png)

> [tab] API
>
> To create a CircleCI Connection via API, send a request to the [Create CircleCI Connection](https://infisical.com/docs/api-reference/endpoints/app-connections/circleci/create.md) endpoint.
>
> ### Sample request
>
> ```bash Request theme={"dark"}
> curl    --request POST \
>         --url https://app.infisical.com/api/v1/app-connections/circleci \
>         --header 'Content-Type: application/json' \
>         --data '{
>             "name": "my-circleci-connection",
>             "method": "api-token",
>             "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
>             "credentials": {
>                 "apiToken": "[API TOKEN]"
>             }
>         }'
> ```
>
> ### Sample response
>
> ```bash Response theme={"dark"}
> {
>   "appConnection": {
>       "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
>       "name": "my-circleci-connection",
>       "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
>       "description": null,
>       "version": 1,
>       "orgId": "6f03caa1-a5de-43ce-b127-95a145d3464c",
>       "createdAt": "2025-04-23T19:46:34.831Z",
>       "updatedAt": "2025-04-23T19:46:34.831Z",
>       "isPlatformManagedCredentials": false,
>       "credentialsHash": "7c2d371dec195f82a6a0d5b41c970a229cfcaf88e894a5b6395e2dbd0280661f",
>       "app": "circleci",
>       "method": "api-token",
>       "credentials": {}
>   }
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.