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

# Spacelift Connection

> Learn how to configure a Spacelift Connection for Infisical.

Infisical supports connecting to Spacelift using an API key ID and API key secret for secure access to your Spacelift account.

## Create an API Key in Spacelift

<Steps>
  <Step title="Navigate to Organization Settings">
    Click on your profile name and select **Organization Settings** at the bottom left side of the Spacelift dashboard.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/spacelift/spacelift-navigate-to-org-settings.png" alt="Navigate to Organization Settings" />
  </Step>

  <Step title="Open API Keys">
    Click on **API Keys** under the identity management section.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/spacelift/spacelift-open-api-keys.png" alt="Open API Keys" />
  </Step>

  <Step title="Create API Key">
    Click on **Create API Key**.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/spacelift/spacelift-create-api-key.png" alt="Create API Key" />
  </Step>

  <Step title="Set a Name">
    Set a name for the API key, choose the type **Secret** and click **Continue**.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/spacelift/spacelift-set-api-key-name.png" alt="Set API Key Name" />
  </Step>

  <Step title="Configure Roles, Space, and Create">
    Select the **Space admin** role (or a custom role with at least **Space reader**, **Space writer**, and **Context update** permissions), choose the Space that will be managed by this credential, then click **Add** and **Create API Key**. A file will be downloaded containing your credentials.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/spacelift/spacelift-select-roles.png" alt="Select Roles" />
  </Step>

  <Step title="Extract Credentials">
    Open the downloaded file and extract the `api_key_id` and `api_key_secret` values.
  </Step>
</Steps>

## Setup Spacelift Connection in Infisical

<Steps>
  <Step title="Navigate to App Connections">
    Navigate to the **Integrations** tab in the desired project, then select **App Connections**.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/general/revamped-app-connection-tab.png" alt="App Connections Tab" />
  </Step>

  <Step title="Add Connection">
    Select the **Spacelift Connection** option from the connection options modal.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/spacelift/spacelift-app-connection-select.png" alt="Select Spacelift Connection" />
  </Step>

  <Step title="Input Credentials">
    Enter your Spacelift API URL, API Key ID, and API Key Secret in the provided fields and
    click **Connect to Spacelift** to establish the connection.

    <Note>
      The API URL is the base URL of your Spacelift account (e.g., `https://myorgname.app.us.spacelift.io/`).
    </Note>

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/spacelift/spacelift-app-connection-form.png" alt="Connect to Spacelift" />
  </Step>

  <Step title="Connection Created">
    Your **Spacelift Connection** is now available for use in your Infisical projects.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/spacelift/spacelift-app-connection-created.png" alt="Spacelift Connection Created" />
  </Step>
</Steps>
