> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Harvest OAuth 2.0 connector profile – StackOne setup guide

> Set up the OAuth 2.0 connector profile for Harvest in StackOne. One-time admin setup required before your users can link Harvest accounts via Hub.

<section data-guide-section data-guide-scopes="">
  <h2>Register an OAuth 2.0 application</h2>

  <p>Create an OAuth2 application in the Harvest Developers portal to obtain the Client ID and Client secret.</p>

  <Steps>
    <Step title="Sign in to Harvest">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://id.getharvest.com/developers" target="_blank" rel="noopener noreferrer">Harvest ID account</a>.</p>

        <ul>
          <li>Open the <strong>Developers</strong> tab to reach the <strong>Developer tools</strong> page.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/harvest/images/oauth2-setup-sign-in.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=fbe0d67c85718e7672a0d797a84c13b7" alt="Harvest ID sign-in screen" width="1280" height="800" data-path="connectors/harvest/images/oauth2-setup-sign-in.png" />
      </div>
    </Step>

    <Step title="Create a new OAuth2 application">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>Developer tools</strong> page, under <strong>OAuth2 applications</strong>, click <strong>Create new OAuth2 application</strong>, then fill in the <strong>New OAuth2 application</strong> form.</p>

        <ul>
          <li>Enter a <strong>Name</strong> for the application (for example, `StackOne Integration`).</li>
          <li>In the <strong>Redirect URL</strong> field, paste the StackOne callback URL: `https://api.stackone.com/connect/oauth2/harvest/callback`</li>
          <li>In the <strong>Access</strong> dropdown, always select <strong>I need access to one account</strong> — do not choose <strong>I can work with multiple accounts</strong>.</li>
          <li>Scoping the app to a single account lets StackOne determine which Harvest Account ID to send on every request. You choose which account to authorize during the connection step, and StackOne then reads that one account and stores its Account ID automatically.</li>
          <li>In the <strong>Products</strong> dropdown, select <strong>I want access to Harvest</strong>.</li>
          <li>Click <strong>Create application</strong>.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/harvest/images/oauth2-setup-create-application.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=2538b00ae1e4bd18339d064e50b2ca0f" alt="New OAuth2 application form with Name, Redirect URL, Access and Products fields" width="1280" height="800" data-path="connectors/harvest/images/oauth2-setup-create-application.png" />
      </div>
    </Step>

    <Step title="Copy the Client ID and Client secret">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After creating the application, the app page shows a <strong>Parameters</strong> section with both credentials.</p>

        <ul>
          <li>Copy the value under <strong>Client ID</strong> and paste it into the <strong>Client ID</strong> field in the StackOne Connector profile.</li>
          <li>Copy the value under <strong>Client secret</strong> and paste it into the <strong>Client Secret</strong> field in the StackOne Connector profile.</li>
          <li>These values remain available on the application page — reopen it from the <strong>Developers</strong> page anytime to view them again.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/harvest/images/oauth2-setup-copy-credentials.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=ff53d91341fbbf32c45833d4f52735a2" alt="Parameters section showing the Client ID and Client secret fields" width="1280" height="800" data-path="connectors/harvest/images/oauth2-setup-copy-credentials.png" />
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Harvest</strong>:

<Steps>
  <Step title="Navigate to Connector Profiles">
    Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  </Step>

  <Step title="Create New Connector Profile">
    <ul>
      <li>Click <strong>+ Connector Profile</strong></li>
      <li>Search for and select <strong>Harvest</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0</strong></li>

      <li>
        Fill out the fields using details retrieved from your provider:

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Client ID</strong></li>
          <li><strong>Client Secret</strong></li>
        </ul>
      </li>

      <li>(Optional) Select <strong>Actions</strong> to be enabled for this Connector Profile</li>
      <li>Click <strong>Create profile</strong></li>
    </ul>
  </Step>
</Steps>

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to <a href="/guides/accounts-section#linking-accounts">Link Accounts</a> for <strong>Harvest</strong>.