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

# CircleCI - How do I link my account?

## Overview

To authenticate with CircleCI, you need:

1. **Personal API Token** — a personal API token from your CircleCI user settings.

> [!NOTE]
>
> Use a personal API token. Project API tokens (Project Settings > API Permissions) are not supported.

This guide will show you how to create it.

### Prerequisites

* A CircleCI account. If you don't have one, [sign up](https://app.circleci.com/signup). No credit card is required.

### Step 1: Create a personal API token

1. Sign in to CircleCI and open [User Settings](https://app.circleci.com/settings/user).
2. Select **Personal API Tokens** in the left menu, then click **Create New Token**.

![CircleCI User Settings with Personal API Tokens selected and the Create New Token button](https://mintcdn.com/nango/OsskBshdjtct8XPs/api-integrations/circleci/user_settings_personal_api_tokens.png?fit=max\&auto=format\&n=OsskBshdjtct8XPs\&q=85\&s=9592ea9840b9d21273193adeea818831)

3. Choose the **Access level** your integration needs (**Read**, **Write** or **Admin**).
4. Enter a name in the **Token name** field.
5. Pick an **Expiry date**. It can be at most one year in the future.
6. Click **Add API Token**.

![CircleCI Create New API Token dialog with the access level, token name and expiry date fields and the Add API Token button](https://mintcdn.com/nango/OsskBshdjtct8XPs/api-integrations/circleci/create_api_token_dialog.png?fit=max\&auto=format\&n=OsskBshdjtct8XPs\&q=85\&s=65e1cf6ccd2de13ba879da5be1d20301)

7. Copy the token. You will not be able to view it again.

![CircleCI dialog showing the new personal API token with a Copy button](https://mintcdn.com/nango/OsskBshdjtct8XPs/api-integrations/circleci/api_token_created.png?fit=max\&auto=format\&n=OsskBshdjtct8XPs\&q=85\&s=992a6c02e023d9f3e58e6e8e4acd1fe7)

### Step 2: Enter your personal API token in the Connect UI

1. Open the form where you need to authenticate with CircleCI.
2. Enter your token in the **Personal API Token** field.
3. Submit the form, and you should be successfully authenticated.

![CircleCI Connect UI form with the Personal API Token field](https://mintcdn.com/nango/OsskBshdjtct8XPs/api-integrations/circleci/form.png?fit=max\&auto=format\&n=OsskBshdjtct8XPs\&q=85\&s=c97b80c9f5353835f804e0a165d82747)

You are now connected to CircleCI.


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