Skip to main content

Register an OAuth 2.0 application

Create an OAuth2 application in the Harvest Developers portal to obtain the Client ID and Client secret.

1

Sign in to Harvest

Sign in to your Harvest ID account.

  • Open the Developers tab to reach the Developer tools page.
Harvest ID sign-in screen
2

Create a new OAuth2 application

On the Developer tools page, under OAuth2 applications, click Create new OAuth2 application, then fill in the New OAuth2 application form.

  • Enter a Name for the application (for example, StackOne Integration).
  • In the Redirect URL field, paste the StackOne callback URL: https://api.stackone.com/connect/oauth2/harvest/callback
  • In the Access dropdown, always select I need access to one account — do not choose I can work with multiple accounts.
  • Scoping the app to a single account lets StackOne determine which Harvest Account ID to send on every request. You choose which account to authorize during the connection step, and StackOne then reads that one account and stores its Account ID automatically.
  • In the Products dropdown, select I want access to Harvest.
  • Click Create application.
New OAuth2 application form with Name, Redirect URL, Access and Products fields
3

Copy the Client ID and Client secret

After creating the application, the app page shows a Parameters section with both credentials.

  • Copy the value under Client ID and paste it into the Client ID field in the StackOne Connector profile.
  • Copy the value under Client secret and paste it into the Client Secret field in the StackOne Connector profile.
  • These values remain available on the application page — reopen it from the Developers page anytime to view them again.
Parameters section showing the Client ID and Client secret fields

Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Harvest:
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 Harvest
  • 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 Harvest.