Skip to main content
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions…
Dynamic Guide URL
Scopes Selected
Separator
Admin access with ‘Can manage ALL organization’s API Credentials’ permission is required in Greenhouse.

Create OAuth 2.0 client credentials

Create OAuth credentials from your Greenhouse account’s Dev Center.

1

Sign in to Greenhouse

Sign in to your Greenhouse account.

  • Click the Configure icon on the navigation bar.
  • Click Dev Center on the left menu.
  • Click API Credential Management.
2

Create new OAuth credentials

Click Create new API credentials and select Harvest V3 (OAuth) as the API type.

  • Enter a description for your credentials (e.g., “StackOne Integration”)
  • Copy the Client ID and Client Secret. Store securely — the Client Secret will not be shown again.
3

Configure scopes

Enables actions: Activate User, Add Job Hiring Manager, Add Job Owner, Convert Prospect To Candidate, Create Application, Create Applied Candidate Tag, Create Attachment, Create Attachment From URL, Create Candidate, Create Candidate Education, Create Candidate Employment, Create Candidate Tag, Create Department, Create Interview, Create Job, Create Job Note, Create Note, Create Offer, Create Office, Create Opening, Create Prospect Application, Create User, Create User Job Permission, Deactivate User, Delete Application, Delete Applied Candidate Tag, Delete Attachment, Delete Candidate, Delete Candidate Education, Delete Candidate Employment, Delete Candidate Tag, Delete Interview, Delete Job Note, Delete Opening, Delete User Job Permission, Hire Application, List Application Stages, List Applications, List Applied Candidate Tags, List Attachments, List Candidate Educations, List Candidate Employments, List Candidate Tags, List Candidates, List Close Reasons, List Custom Field Options, List Custom Fields, List Default Interviewers, List Departments, List Email Templates, List Interview Kits, List Interviewer Tags, List Interviewers, List Interviews, List Job Hiring Managers, List Job Interview Stages, List Job Interviews, List Job Notes, List Job Owners, List Job Post Locations, List Job Posts, List Jobs, List Notes, List Offers, List Offices, List Openings, List Prospect Details, List Prospect Pools, List Prospect Stages, List Referrers, List Rejection Details, List Rejection Reasons, List Scorecard Question Answers, List Scorecard Question Options, List Scorecard Questions, List Scorecards, List Sources, List Tracking Links, List User Job Permissions, List User Roles, List Users, Merge Candidates, Move Application, Reject Application, Remove Job Hiring Manager, Remove Job Owner, Revoke User Permissions, Unreject Application, Update Application, Update Candidate, Update Department, Update Interview, Update Job, Update Job Note, Update Job Post, Update Offer, Update Office, Update Opening, Update User

Navigate to the Settings tab of your newly created credentials. Under Manage Scopes, click the Harvest dropdown and select the scopes for your use case.

4

Find your User ID (optional)

The User ID field is optional — it identifies the Greenhouse user on whose behalf API requests are made.

  • Navigate to Configure > Users.
  • Click on the user and copy the numeric ID from the browser URL.
  • Example: https://app.greenhouse.io/account/users/12345678/edit → User ID is 12345678
  • To find your own User ID, locate your account (marked “(you)”), click Export to Excel, and find your ID in the User ID column.

Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Client ID
  • Client Secret
  • User ID (Optional) (Optional)
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.