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

# Set up a Teamtailor connector

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

C1 provides identity governance for Teamtailor. Integrate your Teamtailor
account with C1 for unified visibility and governance over the people who can
access your Teamtailor recruiting account.

## Capabilities

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

The connector syncs the people on your Teamtailor account as users. Each
person's Teamtailor access role (Admin, Recruiter, User, or No access) is
recorded as an informational attribute on the user, along with their job
title. People whose role is **No access** are marked as disabled. Teamtailor
does not expose access roles as a separately governable resource, so roles are
not synced on their own.

## Gather Teamtailor credentials

<Warning>
  You need to be an administrator of your Teamtailor account to create an API key
  that can read the full list of users.
</Warning>

<Steps>
  <Step>
    Sign in to Teamtailor and open **Settings**.
  </Step>

  <Step>
    Go to **Integrations** > **API keys**.
  </Step>

  <Step>
    Create a new API key with administrator access and copy the key value when
    it is shown.
  </Step>
</Steps>

## Configure the Teamtailor 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 **Apps** > **Connectors** and click **Add connector**.
      </Step>

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

      <Step>
        Choose where to add the connector: **Create a new app**, or **Add to an existing app** (then select the app).

        If you're creating a new app, choose whether to link it to an application discovered from your identity provider: select **Yes** and pick the IdP application, or **No** to continue with just the connector.
      </Step>

      <Step>
        Set the connector's **Name** and, optionally, a **Description**.
      </Step>

      <Step>
        Click the pencil icon next to **Owners** to choose who can configure and manage this connector.
      </Step>

      <Step>
        Click **Add**. The connector is created and its configuration page opens.
      </Step>

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

      <Step>
        Enter the Teamtailor credentials:

        * **Teamtailor API key**: the 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 Teamtailor connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create a secret for the Teamtailor API key.
      </Step>

      <Step>
        Configure the connector with:

        * **Teamtailor API key**: your Teamtailor API key (stored as a secret).
      </Step>

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

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