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

# FreshBooks OAuth 2.0 connector profile – StackOne setup guide

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

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

  <p>Create a FreshBooks developer application to enable OAuth 2.0 authentication.</p>

  <Steps>
    <Step title="Sign in to FreshBooks">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to the <a href="https://my.freshbooks.com/#/developer" target="_blank" rel="noopener noreferrer">FreshBooks Developer Portal</a>.</p>

        <ul>
          <li>Click <strong>Create New App</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Fill in application details">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Complete the <strong>Create Application</strong> form.</p>

        <ul>
          <li>Application Name: `StackOne`</li>
          <li>Select an <strong>Application Type</strong> (for example, <strong>Private App</strong>).</li>
          <li>Enter a brief <strong>Description</strong> (max 140 characters).</li>
          <li>Website URL and Application Settings URL: enter any valid URL (these are not used by StackOne).</li>
        </ul>
      </div>
    </Step>

    <Step title="Add scopes">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under <strong>Scopes</strong>, click <strong>Add Scope</strong> and add each scope required by your integration.</p>
      </div>
    </Step>

    <Step title="Add the redirect URI and create the app">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under <strong>Redirect URIs</strong>, add the StackOne callback URL, then save the application.</p>

        <ul>
          <li>Redirect URI: `https://api.stackone.com/connect/oauth2/freshbooks/callback`</li>
          <li>Click the check icon to save the redirect URI.</li>
          <li>Click <strong>Save</strong> to create the application.</li>
        </ul>
      </div>
    </Step>

    <Step title="Open the app from the apps list">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After creation, you are returned to the <strong>All Apps</strong> list.</p>

        <ul>
          <li>Click your newly created app (for example, <strong>S1DevTest</strong>) to open it.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy client credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Inside the app, copy the <strong>Client ID</strong> and <strong>Client Secret</strong> and store them securely for use later.</p>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>FreshBooks</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>FreshBooks</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>
          <li><strong>Scopes</strong> (Optional)</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>FreshBooks</strong>.