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 the Callback URL from your Connector Profile
  • 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

​
Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.