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

      <Step>
        Search for **Harvest** 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 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>