> ## 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.

# Connect Harvest with Personal Access Token – StackOne Hub

> Link a Harvest account in the StackOne Hub using Personal Access Token. End-user guide to authorize the integration and start using Harvest actions.

<section data-guide-section data-guide-scopes="">
  <h2>Generate a personal access token</h2>

  <p>A personal access token authenticates a single Harvest user and also reveals the Account ID you need.</p>

  <Steps>
    <Step title="Create a new personal access token">
      <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> and open the <strong>Developer tools</strong> page. Under <strong>Personal access tokens</strong>, click <strong>Create new personal access token</strong>.</p>

        <ul>
          <li>Enter a <strong>Name</strong> for the token (for example, `StackOne Integration`).</li>
          <li>Click <strong>Create personal access token</strong>.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/harvest/images/personal_access_token-config-create-token.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=e55d023ef7ddfa4576d76ff3fe8f939d" alt="Developer tools page with the Create new personal access token action" width="1280" height="800" data-path="connectors/harvest/images/personal_access_token-config-create-token.png" />
      </div>
    </Step>

    <Step title="Copy the token and Account ID">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>Your personal access token</strong> page, Harvest shows the token and the matching Account ID.</p>

        <ul>
          <li>If you belong to more than one account, use the <strong>Choose account</strong> dropdown to select the Harvest account this connection should access; the <strong>Account ID</strong> updates to match.</li>
          <li>Copy the value under <strong>Your token</strong> and paste it into the <strong>Personal Access Token</strong> field in StackOne Hub.</li>
          <li>Copy the number shown under <strong>Account ID</strong> (for example, `2229920`) and paste it into the <strong>Account ID</strong> field in StackOne Hub.</li>
          <li>Store the token securely — treat it like a password.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/OmKBo4CDQOnMK2re/connectors/harvest/images/personal_access_token-config-copy-token.png?fit=max&auto=format&n=OmKBo4CDQOnMK2re&q=85&s=5f632dc06db04b53b9427f72ec33fd26" alt="Your personal access token page showing Your token, Choose account and Account ID" width="1280" height="800" data-path="connectors/harvest/images/personal_access_token-config-copy-token.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Set the User-Agent value</h2>

  <p>Harvest requires a User-Agent header on every API request. It must include both the name of your application and a link to your application or a contact email address — requests without a User-Agent are rejected with a 400 Bad Request.</p>

  <Steps>
    <Step title="Enter a User-Agent value">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Fill in the <strong>User-Agent</strong> field in StackOne Hub with your application name followed by a link or email in parentheses.</p>

        <ul>
          <li>Format: `Application Name (link or contact email)`</li>
          <li>Example: `John's Harvest Integration (john@example.com)`</li>
          <li>Example: `Trello (http://trello.com/contact)`</li>
          <li>Using a non-standard value or deviating from this pattern may cause connectivity issues with the Harvest API.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<div data-whitelabel-hide>
  <h2>Linking the Account from the Hub</h2>

  <Steps>
    <Step title="Navigate to the Hub">
      Use one of the three <a href="/guides/accounts-section#linking-accounts">Linking Account Methods</a> to access the Hub.
    </Step>

    <Step title="Fill out the fields">
      Fill out the following fields using details from your provider:

      <ul>
        <li><strong>Personal Access Token</strong></li>
        <li><strong>Account ID</strong></li>
        <li><strong>User-Agent</strong></li>
      </ul>
    </Step>

    <Step title="Connect">
      <ul>
        <li>Click <strong>Connect</strong></li>
        <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
        <li>Once authorization is successful, you will see a confirmation popup</li>
      </ul>
    </Step>
  </Steps>

  <p>If the account linking is successful, you will see the newly linked account in your <a href="/guides/accounts-section">Accounts</a> page.</p>
</div>
