How can we help you?

Starred

Starred provides professional software solutions to collect, analyze, and act on feedback. With the candidate experience more important than ever in recruiting, your organization's recruiting advantage will be understanding the drivers of Candidate Net Promoter Score (NPS).

Greenhouse Recruiting’s integration with Starred allows your organization to create workflows that automatically send feedback surveys to candidates at specific moments in a candidate's interview plan. In this article, we will cover:

 

Note: This integration supports automated feedback surveys to candidates when they are hired or rejected for a particular job.

 

Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Starred integration, you will need the developer permission Can manage ALL organization’s API Credentials and Can manage and configure web hooks.

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon configure.png > Users > Your Name)

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.

Select Can manage ALL organization’s API Credentials and Can manage and configure web hooks so that a check is in the checkboxes.

When finished, click Save.

Screen_Shot_2019-05-28_at_10.33.09_AM.png

 

Create a Harvest API Key for the Greenhouse/Starred Integration

To create a Harvest API key for the integration, click on the Configure icon configure.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.

From the Dev Center page, click API Credential Management.

From the API Credential Management page, click Create New API Key to generate the API key for Starred.

From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.

On the Manage API Key Permissions page, select the following permissions:

  • Jobs
    • GET: Retrieve Job
  • Users
    • GET: Retrieve User

When finished, click Update.

Back on the API Credential management page, navigate to the newly created Harvest API key and click Copy.

Screen_Shot_2019-05-28_at_9_49_26_AM.jpg

 

Enter Greenhouse Harvest API Key In Starred

From your Starred account and click Connect from the navigation bar.

Navigate to the Greenhouse integration card and click Connect.

Enter the Greenhouse Harvest API key in the provided space and click Continue when finished.

 

Retrieve Web Hook Credentials

Before enabling the Greenhouse/Starred integration, Greenhouse will need two pieces of information:

  • Starred’s Endpoint URL
  • Starred’s Secret Key

You can retrieve this information from Starred Connect Web hook setup page.

 

 

Create Greenhouse Recruiting Web Hooks

With the Starred credentials copied from the previous step, navigate to Greenhouse Recruiting.

The Greenhouse Recruiting/Starred integration supports the following functions when creating workflows.

  • Candidate Hired - Triggers when a candidate has been hired.
  • Candidate Rejected - Triggers when a candidate or prospect’s application is rejected

 Your organization will need to create two separate web hooks for each of the workflows.

To enable the integration, click the Configure icon configure.png in the upper right-hand corner and navigate to Dev Center on the left-hand panel.

From the Dev Center page, click Web Hooks. Click Web Hooks from the subsequent page. 

You will be directed to a new page where you Create a New Web Hook. From this page provide the following details: 

  • Name: we suggest Starred Integration
  • When: Candidate has been hired
  • Endpoint URL: The Endpoint URL retrieved from the Starred Connect
  • Secret Key: The Secret Key retrieved from the Starred Connect

When finished, click Create Web hook

Screen_Shot_2019-05-28_at_10.11.17_AM.png 

Use the above steps and credentials to create a second web hook:

  • Name: we suggest Starred Integration
  • When: Candidate has been rejected
  • Endpoint URL: The Endpoint URL retrieved from the Starred Connect
  • Secret Key: The Secret Key retrieved from the Starred Connect

When finished, click Create Web hook.  

Once you have created both web hooks in Greenhouse Recruiting, navigate back to the Starred integration setup page and click Validate Webhooks.

When both web hooks are validated (as shown in the image below), click Finish Setup

 

  

Integration Workflows

Once your integration is properly configured, you can go ahead and create workflows to automate feedback surveys on different touchpoints. You can create a workflow from scratch by selecting Greenhouse as a trigger and Starred as an action or you can create a workflow using pre-built templates.

 

Need Help?

Please contact greenhouse@starred.com for troubleshooting assistance regarding the integration.