You must be a Greenhouse Integration Partner to enable the Greenhouse Partner API integration and access the Greenhouse Assessment flow.

​
Become a Greenhouse Integration Partner

1

Apply to the Greenhouse Integration Partner Program

Visit the Greenhouse Integration Partner application page and start the partner application process.
2

Select Integration Types

On the application form, select Assessment API, Webhook, and Harvest API as your integration types.
When you select Assessment API, you will be prompted to provide specific API endpoint URLs (see screenshot below).
3

Provide StackOne Endpoint URLs

Enter the following StackOne endpoint URLs in the form:list_tests
https://api.stackone.com/external-trigger/greenhouse/list_tests?tenant-id=YOUR_GREENHOUSE_TENANT_ID
send_test
https://api.stackone.com/external-trigger/greenhouse/send_test?tenant-id=YOUR_GREENHOUSE_TENANT_ID
test_status
https://api.stackone.com/external-trigger/greenhouse/test_status?tenant-id=YOUR_GREENHOUSE_TENANT_ID
response_error
https://api.stackone.com/external-trigger/greenhouse/response_error?tenant-id=YOUR_GREENHOUSE_TENANT_ID
About the Tenant ID: The tenant-id parameter in these URLs should be replaced with a unique identifier of your choice. This ID is not provided by Greenhouse and is not generated by StackOne. You can use any unique value (e.g., your company name like example-inc or acme-corp). This parameter is used by Greenhouse to create uniquely routed endpoints and distinguish between different integrations. Choose a value that makes sense for your organization and use it consistently across all endpoints.
Greenhouse Assessment API Endpoint Form
4

Submit the application

Greenhouse reviews applications on the first Monday of every month. A member of their Partnerships team will contact you with next steps.
5

Provide an example API Key

If Greenhouse support requests an example API key, you can provide the following djEuZXUxLlJ2QkhKS01XQXJmVFhETUIwbF9EEV9iS2lzZTdfX20wdTWmOEtIVUk1djBicWRjRUZHSURoOHBfSHZpNDJyQlF4eTJGXzFmY3ZZV2N3YUJLeDlOV1Nn

​
To Enable and Connect the Integration

1

Go to the ATS category

Navigate to the Integrations page and activate Greenhouse.
Configuration
2

Fill out the configuration form

Please fill out all the required fields in the Greenhouse - Configuration model.
  • Authentication Type - Please select either Public + Partner API or Partner API to integrate with Greenhouse.
  • Partner Category - Select the appropriate category based on your integration’s classification as a partner for Greenhouse.
  • Package’s List Endpoint URL - The endpoint URL that StackOne will use to retrieve the list of packages when the recruiter intends to send a test to the candidate.
  • Partner’s Username - You will receive the username from Greenhouse support as mentioned in the previous step.
  • Partner’s Password - The password will also be provided by Greenhouse support, as stated earlier.
  • Package ID - If you do not have the Package List Endpoint URL, you can specify a particular package ID that will be visible to the recruiter when they wish to send the test to the candidate.
Greenhouse Configuration Form
3

Save your configuration

Click on the Confirm or Save Changes button to enable your Partner APIs, which allows end-users to link their accounts via the Hub.

​
What will the customer see?

When a customer activates integration from StackOne Hub, they will see ‘Integration’ as the stage in their Interview Plan to send an assessment or background check.
Customer view of integration stage

​
What will the customer see after an assessment or background check has been sent?

When a customer sends an assessment to a candidate, they see a success message along with the application stage.
Send Webhook Success

​
How will the results of the assessment or background check be displayed to the customer?

When a customer opens a candidate application, they will see their updated score along with the application stage.
Updated Result