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

# Gusto OAuth 2.0 connector profile – StackOne setup guide

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

<Warning>A Gusto Developer Portal account is required to register an OAuth application. Production credentials require pre-approval from Gusto's Partnerships team.</Warning>

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

  <p>Register an application in the Gusto Developer Portal to obtain OAuth credentials for API access.</p>

  <Steps>
    <Step title="Create a Developer Portal Account">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Go to the <a href="https://dev.gusto.com/" target="_blank" rel="noopener noreferrer">Gusto Developer Portal</a> and create an account if you don't have one.</p>

        <ul>
          <li>Click <strong>Sign Up</strong> to create a new developer account</li>
          <li>Accept the terms of service</li>
          <li>Complete account verification</li>
        </ul>
      </div>
    </Step>

    <Step title="Create a New Application">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Once signed in, click <strong>Applications</strong> in the left sidebar, then click <strong>Create application</strong> and fill in the application details.</p>

        <ul>
          <li><strong>Application name</strong>: Enter a name for your application (e.g., StackOne Integration)</li>
          <li><strong>Organization</strong>: Select your organization from the dropdown</li>
          <li><strong>Redirect URI</strong>: Enter `https://api.stackone.com/connect/oauth2/gusto/callback`</li>
          <li><strong>Category</strong>: Select the appropriate category for your integration</li>
          <li>If building a time tracking integration, check <strong>Disable Gusto's time tracking features</strong></li>
          <li>Click <strong>Create</strong> to register the application</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy Client Credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After creating your application, copy the <strong>Client ID</strong> and <strong>Client Secret</strong> from the application credentials page and store them securely for use later.</p>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Understanding Environments</h2>

  <p>Gusto provides separate environments for development and production.</p>

  <Steps>
    <Step title="Sandbox Environment">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Initial credentials provide access to the Demo environment for development and testing.</p>

        <ul>
          <li>API Base URL: `https://api.gusto-demo.com`</li>
          <li>Use demo accounts to build and test your integration</li>
          <li>No real payroll data is processed in this environment</li>
        </ul>
      </div>
    </Step>

    <Step title="Production Environment">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Production credentials are issued after your integration is approved.</p>

        <ul>
          <li>Complete the Production Pre-Approval application in the Developer Portal</li>
          <li>Wait for approval from Gusto's Partnerships team</li>
          <li>Once approved, production credentials will be available in your Developer Portal</li>
          <li>Production API Base URL: `https://api.gusto.com`</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>OAuth Authorization Requirements</h2>

  <p>Understand the user requirements for authorizing your application.</p>

  <Steps>
    <Step title="Admin Authorization">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Only users with specific admin roles can authorize applications.</p>

        <ul>
          <li>Primary admins can authorize applications</li>
          <li>Full-access admins can authorize applications</li>
          <li>Multi-company administrators must complete OAuth separately for each company</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Gusto</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>Gusto</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>Gusto</strong>.