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

# Windmill connection

> Learn how to configure a Windmill Connection for Infisical.

Infisical supports connecting to Windmill using Access Tokens.

## Get a Windmill access token

Ensure the user generating the access token has the required role and permissions based on your use-case:

> [tab] Secret Sync
>
> > [!NOTE]
> >
> > The user generating the access token should be at least a `Developer` in the configured workspace and have `write` permissions for the workspace path secrets will be synced to.

**1. Navigate to Account Settings**

In Windmill, select your user in the sidebar and select **Account Settings**.

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

**2. Access Token Section**

In the **Tokens** section on the drawer, select **Create token**.

![Windmill Create Token](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/windmill/windmill-create-token.png)

**3. Create Access Token**

Give your token a name and select **New token**.

> [!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.

![Windmill New Token](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/windmill/windmill-new-token.png)

**4. Copy Access Token**

Copy your new access token and save it for the steps below.

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

## Setup Windmill 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 **Windmill Connection** option.
>
> ![Select Windmill Connection](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/windmill/select-windmill-connection.png)
>
> **3. Configure Connection**
>
> Configure your Windmill Connection using the access token generated in the steps above. Then click **Connect to Windmill**.
>
> ![Windmill Configure Connection](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/windmill/create-windmill-access-token.png)
>
> * **Name**: The name of the connection to be created. Must be slug-friendly.
> * **Description**: An optional description to provide details about this connection.
> * **Instance URL**: The URL of your Windmill instance. If you are not self-hosting Windmill you can leave this field blank.
> * **Access Token**: The access token generated in the steps above.
>
> **4. Connection Created**
>
> Your Windmill Connection is now available for use.
>
> ![Windmill Connection Created](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/windmill/windmill-access-token-created.png)

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


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