Skip to main content
A signed Greenhouse partnership agreement is required to use Partner OAuth 2.0.

​
Client or Partner Authentication

OAuth 2.0 (Partner) is the standard authentication method for StackOne–Greenhouse integrations. Use it unless you’re self-hosting StackOne to connect your own Greenhouse tenant (in which case use OAuth 2.0 (Client) instead). To proceed with OAuth 2.0 (Partner), continue below.

​
Obtain Partner OAuth credentials

You will need a signed Greenhouse partnership agreement and OAuth credentials issued by Greenhouse.

1

Contact Greenhouse Partner Support

Reach out to Greenhouse Partner Support at partner-support@greenhouse.io with the following information.

  • Integration Name — your product or integration name
  • Environment — choose testing (sandbox only) or production (live customer access)
  • Redirect URI — https://api.stackone.com/connect/oauth2/greenhouse/callback
  • Logo — provide a 128x128 pixel image for the authorization consent screen
  • Required Scopes — list the specific data permissions needed from the list below
2

Request required 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

Request the scopes necessary for your use case:

3

Receive and store credentials

Greenhouse will provide you with a Client ID and Client Secret. Store these securely — the Client Secret must be kept confidential.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Greenhouse - Harvest v3:
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 Greenhouse - Harvest v3
  • Select Type as OAuth 2.0 (Partner)
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (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 Greenhouse - Harvest v3.