> ## 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.

# TeamCity connection

> Learn how to configure a TeamCity Connection for Infisical.

Infisical supports connecting to TeamCity using Access Tokens.

## Setup TeamCity connection in Infisical

**1. Navigate to your profile on TeamCity**

Navigate to the TeamCity **Profile** page by selecting your profile icon in the bottom-left corner.

![TeamCity Main Page](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/teamcity/teamcity-main-page.png)

**2. Select Access Tokens Tab**

Select the **Access Tokens** tab from the left sidebar navigation menu.

![TeamCity Token Page](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/teamcity/teamcity-token-page.png)

**3. Create the Access Token**

Select the **Create access token** button and provide a name for your token (e.g., "Infisical Integration"). You may set an expiration date or leave it blank for no expiry.
The permission scope can either be **Same as current user** or **Limit per project**.

If you're choosing **Limit per project**, make sure you select the relevant project and enable the permissions relevant to your use case:

> [tab] Secret Sync Permissions
>
> * View build configuration settings
> * Edit project

![TeamCity Token Popup](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/teamcity/teamcity-token-popup.png)

> [!NOTE]
>
> Setting your permission scope to **Same as current user** will allow your integration to access multiple projects as long as the current user has read and write access to them.

> [!NOTE]
>
> If you configure an expiry date for your access token, you must manually rotate to a new token before the expiration date to prevent service interruption.

**4. Copy the Access Token**

After creation, a modal with the Access Token will be displayed. Copy this token immediately and store it securely, as you won't be able to view it again after closing this dialog.

![TeamCity Token Copy Popup](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/teamcity/teamcity-token-copy.png)

**5. Token Created**

You should now see your newly created token in the list of access tokens.

![TeamCity Token Created](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/teamcity/teamcity-token-created.png)

**6. Setup TeamCity 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. Add Connection
>
>    Click the **+ Add Connection** button and select the **TeamCity Connection** option from the available integrations.
>
>    ![Select TeamCity Connection](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/teamcity/teamcity-app-connection-option.png)
> 3. Fill the TeamCity Connection Modal
>
>    Complete the TeamCity Connection form by entering:
>
>    * A descriptive name for the connection
>    * The Access Token you generated in steps 3-4
>    * The URL of your TeamCity instance
>    * An optional description for future reference
>
>    ![TeamCity Connection Modal](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/teamcity/teamcity-app-connection-modal.png)
> 4. Connection Created
>
>    After you select **Connect to TeamCity**, your **TeamCity Connection** is established and ready to use with your Infisical project.
>
>    ![TeamCity Connection Created](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/teamcity/teamcity-app-connection-created.png)

> [tab] API
>
> To create a TeamCity Connection, make an API request to the [Create TeamCity
> Connection](https://infisical.com/docs/api-reference/endpoints/app-connections/teamcity/create.md) API endpoint.
>
> ### Sample request
>
> ```bash Request theme={"dark"}
> curl    --request POST \
>         --url https://app.infisical.com/api/v1/app-connections/teamcity \
>         --header 'Content-Type: application/json' \
>         --data '{
>             "name": "my-teamcity-connection",
>             "method": "access-token",
>             "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
>             "credentials": {
>                 "accessToken": "...",
>                 "instanceUrl": "https://yourcompany.teamcity.com"
>             }
>         }'
> ```
>
> ### Sample response
>
> ```bash Response theme={"dark"}
> {
>   "appConnection": {
>     "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
>     "name": "my-teamcity-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": "teamcity",
>     "method": "access-token",
>     "credentials": {
>       "instanceUrl": "https://yourcompany.teamcity.com"
>     }
>   }
> }
> ```


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