Skip to main content
A Gusto Developer Portal account is required to register an OAuth application. Production credentials require pre-approval from Gusto’s Partnerships team.

Register an OAuth Application

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

1

Create a Developer Portal Account

Go to the Gusto Developer Portal and create an account if you don’t have one.

  • Click Sign Up to create a new developer account
  • Accept the terms of service
  • Complete account verification
2

Create a New Application

Once signed in, click Applications in the left sidebar, then click Create application and fill in the application details.

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

Copy Client Credentials

After creating your application, copy the Client ID and Client Secret from the application credentials page and store them securely for use later.

Understanding Environments

Gusto provides separate environments for development and production.

1

Sandbox Environment

Initial credentials provide access to the Demo environment for development and testing.

  • API Base URL: https://api.gusto-demo.com
  • Use demo accounts to build and test your integration
  • No real payroll data is processed in this environment
2

Production Environment

Production credentials are issued after your integration is approved.

  • Complete the Production Pre-Approval application in the Developer Portal
  • Wait for approval from Gusto’s Partnerships team
  • Once approved, production credentials will be available in your Developer Portal
  • Production API Base URL: https://api.gusto.com

OAuth Authorization Requirements

Understand the user requirements for authorizing your application.

1

Admin Authorization

Only users with specific admin roles can authorize applications.

  • Primary admins can authorize applications
  • Full-access admins can authorize applications
  • Multi-company administrators must complete OAuth separately for each company

Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Gusto:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Gusto
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Gusto.