> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-mcp-bridge-private-server.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up an Aha! connector

> C1 provides identity governance for Aha!. Integrate your Aha! account with C1 for unified visibility and governance over user access.

C1 provides identity governance for Aha!. Integrate your Aha! account with C1
for unified visibility and governance over user access.

## Capabilities

| Resource | Sync                                                          | Provision |
| -------- | ------------------------------------------------------------- | --------- |
| Users    | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Teams    | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

## Gather Aha! credentials

<Warning>
  The connector reads your account with a personal API key. The key inherits the
  permissions of the account that created it, so use an account that can read
  users and teams.
</Warning>

<Steps>
  <Step>
    In Aha!, open **Settings** > **Personal** > **Developer**.
  </Step>

  <Step>
    Create a new personal API key and copy it. It is shown only once.
  </Step>

  <Step>
    Note your account URL. It is `https://your-account.aha.io`, where
    `your-account` is the account name shown in your Aha! address bar. Do not
    include a trailing slash or an `/api` suffix.
  </Step>
</Steps>

## Configuration fields

| Field      | Required | Description                                                                                                    |
| ---------- | -------- | -------------------------------------------------------------------------------------------------------------- |
| `base-url` | Yes      | The base URL of your Aha! account, `https://your-account.aha.io`, with no trailing slash and no `/api` suffix. |
| `api-key`  | Yes      | A personal API key from **Settings > Personal > Developer**, sent as a bearer token on every request.          |

## Synced resource types

* **Users**: account users from `/api/v1/users`.
* **Teams**: teams from `/api/v1/teams`, each with a single **member**
  entitlement.
* **Team membership**: member grants from each team's membership list.

## Special notes

* Provisioning is not supported in the current build. The connector is
  read-only.
* The connector authenticates with a personal API key sent as a bearer token.
* An Aha! team can include virtual users — capacity-planning placeholders that
  do not have an Aha! user account. Virtual users are not synced as users and
  do not receive member grants. Teams that include virtual members show member
  grants only for their real Aha! users.
* One connector reads one Aha! account. To cover multiple accounts, configure
  one connector per account.

## Configure the Aha! connector

<Tabs>
  <Tab title="Cloud-hosted">
    Follow these instructions to use a built-in, no-code connector hosted by C1.

    <Steps>
      <Step>
        In C1, navigate to **Integrations** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **Aha!** and click **Add**.
      </Step>

      <Step>
        Choose how to set up the new Aha! connector.
      </Step>

      <Step>
        Set the owner for this connector.
      </Step>

      <Step>
        Click **Next**.
      </Step>

      <Step>
        Find the **Settings** area of the page and click **Edit**.
      </Step>

      <Step>
        Paste the Aha! credentials into the relevant fields:

        * **Aha! account URL**: `https://your-account.aha.io`.
        * **API key**: The personal API key you created.
      </Step>

      <Step>
        Click **Save**.
      </Step>

      <Step>
        The connector's label changes to **Syncing**, followed by
        **Connected**. You can view the logs to ensure that information is
        syncing.
      </Step>
    </Steps>

    **Done.** Your Aha! connector is now pulling access data into C1.
  </Tab>

  <Tab title="Self-hosted">
    Follow these instructions to run the Aha! connector in your own environment.

    <Steps>
      <Step>
        In C1, navigate to **Integrations** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **Baton** and click **Add**.
      </Step>

      <Step>
        Choose how to set up the new Aha! connector, set the owner, and click
        **Next**.
      </Step>

      <Step>
        In the **Settings** area, click **Edit**, then click **Rotate** to
        generate a new Client ID and Client Secret. Store these values securely
        for your deployment.
      </Step>

      <Step>
        Configure C1 credentials and Aha! credentials as environment variables:

        ```bash theme={"theme":{"light":"css-variables","dark":"css-variables"}}
        BATON_CLIENT_ID=<C1 client ID>
        BATON_CLIENT_SECRET=<C1 client secret>
        BATON_HOST_ID=baton-aha
        BATON_BASE_URL=https://your-account.aha.io
        BATON_API_KEY=<Aha! personal API key>
        ```
      </Step>
    </Steps>

    **Done.** Your Aha! connector is now pulling access data into C1.
  </Tab>
</Tabs>