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

# Set up a Harvest connector

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

C1 provides identity governance for Harvest. Integrate your Harvest account
with C1 for unified visibility and governance over the people who can access
your Harvest time-tracking account.

## Capabilities

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

The connector syncs the people in your Harvest account as users. Each person's
Harvest access roles (Administrator, Manager, or Member, plus any manager
sub-permissions) are recorded as an informational attribute on the user, along
with their time zone and whether they are a contractor. Harvest does not expose
access roles as a separately governable resource, so roles are not synced on
their own.

## Gather Harvest credentials

<Warning>
  You need to be an administrator of your Harvest account to create a personal
  access token that can read the full list of people.
</Warning>

<Steps>
  <Step>
    Sign in to Harvest and open the developer tokens page at
    `https://id.getharvest.com/developers`.
  </Step>

  <Step>
    Click **Create New Personal Access Token**. Give it a name and copy the
    token value when it is shown.
  </Step>

  <Step>
    On the same page, copy the **Account ID** shown alongside the token. Every
    Harvest API request must be scoped to this account.
  </Step>

  <Step>
    Copy two values: your **personal access token** and your **Account ID**.
  </Step>
</Steps>

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

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

        * **Harvest personal access token**: the token you created.
        * **Harvest Account ID**: your Harvest account ID.
      </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 Harvest connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create a secret for the Harvest personal access token.
      </Step>

      <Step>
        Configure the connector with:

        * **Harvest personal access token**: your Harvest token (stored as a secret).
        * **Harvest Account ID**: your Harvest account ID.
      </Step>

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

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