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

# Terraform Cloud connection

> Learn how to configure a Terraform Cloud Connection for Infisical.

Infisical supports connecting to Terraform Cloud using a service user.

## Setup Terraform Cloud connection in Infisical

**1. Move to Account Settings on Terraform Cloud**

Navigate to the Terraform Cloud **Account Settings** tab.

![Terraform Cloud Account Settings](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/terraform-cloud/terraform-cloud-account-settings.png)

**2. Move to Tokens Tab**

Move to the **Tokens** tab.

![Terraform Cloud Tokens Tab](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/terraform-cloud/terraform-cloud-tokens-tab.png)

**3. Create the API Token**

Create the API token to be used by Infisical.

> [!NOTE]
>
> If you configure an expiry date for your API token you'll need to manually rotate to a new token prior to expiration to avoid integration downtime.

![Terraform Cloud Create API Token](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/terraform-cloud/terraform-cloud-create-api-token.png)

**4. Copy the API Token**

The API token will be displayed after creating it. Save the token in a secure location for later use in the following steps.

![Terraform Cloud Copy API Token](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/terraform-cloud/terraform-cloud-copy-api-token.png)

**5. Add Terraform Cloud Connection in Infisical**

> [tab] Infisical UI
>
> 1. 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 the **Terraform Cloud Connection** option from the connection options modal.
>
>    ![Select Terraform Cloud Connection](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/terraform-cloud/terraform-cloud-app-connection-option.png)
> 3. Fill out the Terraform Cloud Connection modal, here you'll need to provide the API Token generated in the previous step.
>
>    ![Terraform Cloud Connection Modal](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/terraform-cloud/terraform-cloud-app-connection-modal.png)
> 4. Your **Terraform Cloud Connection** is now available for use.
>
>    ![Terraform Cloud Connection Created](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/terraform-cloud/terraform-cloud-app-connection-created.png)

> [tab] API
>
> To create an Terraform Cloud Connection, make an API request to the [Create Terraform Cloud
> Connection](https://infisical.com/docs/api-reference/endpoints/app-connections/terraform-cloud/create.md) API endpoint.
>
> ### Sample request
>
> ```bash Request theme={"dark"}
> curl    --request POST \
>         --url https://app.infisical.com/api/v1/app-connections/terraform-cloud \
>         --header 'Content-Type: application/json' \
>         --data '{
>             "name": "my-terraform-cloud-connection",
>             "method": "api-token",
>             "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
>             "credentials": {
>                 "apiToken": "...",
>             }
>         }'
> ```
>
> ### Sample response
>
> ```bash Response theme={"dark"}
> {
>     "appConnection": {
>         "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
>         "name": "my-terraform-cloud-connection",
>         "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
>         "version": 123,
>         "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
>         "createdAt": "2023-11-07T05:31:56Z",
>         "updatedAt": "2023-11-07T05:31:56Z",
>         "app": "terraform-cloud",
>         "method": "api-token",
>         "credentials": {
>             "apiToken": "..."
>         }
>     }
> }
> ```


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