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.

Finding your API Key to give to Greenhouse

Important: A single StackOne account can only be linked to one Greenhouse account. All testing must be done through the same StackOne account.

Step 1: Generate your External Trigger Token

1

Navigate to your StackOne account

Log into your StackOne dashboard and go to the Accounts tab.
2

Connect your Greenhouse account

Link a Greenhouse test account to StackOne.
3

Copy the External Trigger Token

After connecting, you’ll see an External Trigger Token. Copy this token - this is the API key you’ll provide to Greenhouse.
External Trigger Token

Step 2: Provide the API Key to Greenhouse

For Partners: Greenhouse support will require this API key when you apply for your test account.For Customers: Each of your customers will need to follow the same process when they want to connect the integration.
1

Contact Greenhouse Support

Reach out to Greenhouse support with your External Trigger Token (API key).
2

Receive Partnership Credentials

Once approved, Greenhouse will provide you with:
  • Partner Username
  • Partner Password
  • Any additional credentials needed
3

Configure StackOne

Use these credentials to complete the StackOne configuration as described in the next section.

Enable and Configure the StackOne Connector

1

Go to the ATS category

Navigate to the Integrations page and activate Greenhouse.
Configuration
2

Fill out the configuration form

Fill out all the required fields in the Greenhouse - Configuration model:
  • Authentication Type - Select either Public + Partner API or Partner API to integrate with Greenhouse. If you only want to test the Assessment/Background Check flow, select Partner API.
  • 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 Greenhouse completes the configuration process, your customer will see a new 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 will 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 the updated score along with the application stage.
Updated Result