Register an OAuth Application
Register an application in the Gusto Developer Portal to obtain OAuth credentials for API access.
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
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
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.
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
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.
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:Navigate to Connector Profiles
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