> ## 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 a HappyFox connector

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

C1 provides identity governance for HappyFox. Integrate your HappyFox account
with C1 for unified visibility and governance over the staff who can access
your HappyFox help desk.

## Capabilities

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

The connector syncs your HappyFox staff (agents). Each staff member's role is
recorded as an informational attribute. HappyFox does not expose roles as a
separate, governable resource, so roles are not synced on their own.

## Gather HappyFox credentials

<Warning>
  You need a HappyFox account with API access. Generating an API key requires
  account-administrator permissions in HappyFox.
</Warning>

<Steps>
  <Step>
    Sign in to your HappyFox account at `https://<subdomain>.happyfox.com`,
    where `<subdomain>` is the first part of your HappyFox web address.
  </Step>

  <Step>
    Go to **Manage** > **Integrations** > **API** and enable the REST API.
    HappyFox generates two values: an **API key** and an **auth code**.
  </Step>

  <Step>
    Copy three values: your **subdomain** (the `<subdomain>` part of your
    HappyFox URL), the **API key**, and the **auth code**.
  </Step>
</Steps>

## Configure the HappyFox 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 **HappyFox** and click **Add**.
      </Step>

      <Step>
        Choose how to set up the new HappyFox 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>
        Enter the HappyFox credentials:

        * **Subdomain**: your HappyFox subdomain, e.g. `acme`.
        * **API key**: the API key from your HappyFox API settings.
        * **Auth code**: the auth code from your HappyFox API settings.
      </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 HappyFox connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create secrets for the HappyFox API key and auth code.
      </Step>

      <Step>
        Configure the connector with:

        * **Subdomain**: your HappyFox subdomain, e.g. `acme`.
        * **API key**: the API key (stored as a secret).
        * **Auth code**: the auth code (stored as a secret).
      </Step>

      <Step>
        Deploy the connector using your standard self-hosted connector process.
      </Step>
    </Steps>

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