Track job applicants in Greenhouse

VideoAsk is a powerful recruitment method to collect job applications and screen candidates via video. If you're using the tool in this way, tracking candidates in an ATS like Greenhouse can help you keep them (and their videoask responses) organized.

Jump to:

Generate Harvest API Key

Generate Job Board API Key

Connect your videoask

Configure your Greenhouse job posting for VideoAsk

View your candidates

Edit the integration

Disconnect your videoask

What does the integration do?

Connecting your videoask to Greenhouse allows you to screen candidates, receive job applications, and have asynchronous video conversations with applicants in VideoAsk while logging all this activity and storing applicant details in Greenhouse. 

2021-07-01_14-18-02.png

When setting up this integration you'll be prompted to match which questions in your videoask correspond with job posting questions in Greenhouse. In this way a candidate can submit their entire job application in VideoAsk and their information will automatically appear in their Greenhouse profile. 

To use the tools together, you'll need to generate both a Harvest and Job Board API Key in Greenhouse and finish the setup process from within your VideoAsk account.

Generate Harvest API Key

Note: To generate Greenhouse API Keys, you will need to have a developer role with permissions to: "Manage ALL organization's API Credentials".

1

From the Greenhouse dashboard, click Settings

2021-06-22_15-10-20.png

2

Click Dev Center

2021-06-22_15-10-30.png

3

Select API Credential Management

2021-06-22_15-10-38.png

4

Click Create New API Key

2021-06-22_15-15-52.png

5

Under API Type select Harvest. Give your API Key a description, then click Create.

2021-06-22_15-26-13.png

6

Copy your API Key and store it in a safe place (you will need this later in VideoAsk).

This will be your only chance to view your API Key, so make sure you have it securely stored. When ready, click I have stored the API Key to proceed to the API permissions.

2021-06-22_15-26-37.png

Important: The API Key gives access and management privileges to your Greenhouse job postings. This means that anyone who has the API Key will be able to use any of the permissions associated with it. Treat your API Key as you would a password: store it in a secure place and share it only over secure networks.

7

You'll now need to configure what information can be called using this API Key. 

Under Candidates select the following options:

2021-06-23_15-41-13.png

Under Departments, select Get: Retrieve Department and Get: List Departments

2021-06-23_15-41-43.png

Under Job Posts, select all except Patch: Update job posts

2021-06-23_15-42-28.png

Under Users, select Get: Retrieve User and Get: List Users

2021-06-23_15-43-00.png

Finally, under Custom Fields select Get: Get custom fields

2021-06-23_15-43-18.png

8

When finished, make sure to click Save. 

2021-06-22_15-37-10.png

Generate Job Board API Key

1

You'll now need to generate the second API Key. From the Dev Center, click Create New API Key

2021-06-22_15-15-52.png

2

Select Job Board, enter a description and click Create.

2021-06-22_18-14-12.png

3

Make sure to Copy your API Key and store it in a safe place. This will be your only chance to view your API Key, so make sure you have it securely stored. When you're ready, click I have stored the API Key.

2021-06-22_15-26-37.png

Connect your videoask

Now it's time to connect your videoask to Greenhouse. You'll need the two API Keys you just saved, so make sure you have them handy.

1

In your VideoAsk account, click Connect for the form you're using to collect applications from candidates.

2021-06-22_18-19-55.png

2

Scroll down to Greenhouse and click Connect

2021-06-22_18-22-50.png

3

Under the Harvest API, click New Authentication

2021-06-22_18-27-05.png

4

Paste the Harvest API Key that you saved previously and click Create

2021-06-22_18-28-35.png

5

Under Job Board API click New authentication

2021-06-23_08-22-47.png

6

Paste the Job board API Key you saved previously and click Create

2021-06-23_08-23-21.png

7

Once both API Keys have been added click Next

2021-06-23_08-23-36.png

8

Enter the email address associated with your Greenhouse account. This will allow us to add notes to the activity feed in Greenhouse based on your activity interacting with candidates in VideoAsk.

2021-07-01_09-19-41.png

Note: If you enter a different email address than the one used for your Greenhouse account, this part of the integration will not work. Adding notes in Greenhouse must also be included in your Greenhouse user permissions. 

2021-07-01_14-10-30.png

9

Select which job post you want to connect this videoask to and click Next. Be aware that you can only connect each videoask to one job post, but you can connect multiple videoasks to the same job post.

2021-06-23_08-24-47.png

10

Now you'll need to map which contact form fields and steps in your videoask correspond with job posting questions in Greenhouse. Select the question in VideoAsk and match it with the appropriate job post question from the dropdown menus.

In general you'll want field types to match (ie a file upload question in VideoAsk mapped to an attachment field in Greenhouse). The exception to this is button or multiple choice questions: these VideoAsk answer types cannot currently be integrated, so they must be mapped to a text question in Greenhouse. Learn more about how to configure your Greenhouse job posting to work with VideoAsk.

2021-06-28_18-31-05.png

Note: Currently the VideoAsk contact form collects the respondent's name in one field. When sending this information to Greenhouse, we will automatically split the name so the first word of the respondent's name = "first name" and all other words in their name = "last name". 

Click Add a new mapping to map additional fields.

2021-06-28_18-42-16.png

11

When you're done mapping, click Finish

2021-06-28_18-44-08.png

Configure your Greenhouse job posting for the VideoAsk integration

If VideoAsk will be an important part of the application process, there are a few integration restrictions to keep in mind when building your Greenhouse job posting.

What are the limitations?

Currently the VideoAsk integration does not support 3 Greenhouse question types: single select, multi select, and Yes/No. We will support all question types when technical constraints allow, but in the meantime you can use Short or Long Textboxes to receive multiple choice or button answer types from VideoAsk.

For example: Step 2 of my videoask application form uses multiple choice buttons to ask how many years of experience an applicant has.

2021-07-01_12-36-56.png

When I configure this custom question in Greenhouse, I will choose to receive answers as a Short Textbox, not Multi Select. 

2021-07-01_12-33-40.png

Note: If you have enabled multiple selection for the step in VideoAsk, all the options a respondent selects will display in the Greenhouse textbox separated by commas.

What happens if I try using an unsupported question type?

When mapping fields in the VideoAsk connect panel, you will see all Greenhouse questions in your job posting (including those that are not supported by the integration). If you map a VideoAsk question to a single select, multi select, or Yes/No question in Greenhouse it will not disrupt other fields that have been properly mapped, but no data will be sent for these questions.

Contact details and candidate profiles

First name, last name, and email are required fields to create a candidate profile for a job posting in Greenhouse. Assuming you have enabled a contact form in your videoask, this information will be collected and automatically transmitted to Greenhouse along with their other application answers.

If you'd rather collect contact information with a videoask step instead of the contact form, you can also map an open answer question in VideoAsk to the relevant contact field in Greenhouse.

2021-07-01_12-49-04.png

When doing this, bear in mind that at least an email address is required by Greenhouse to create an candidate profile and submit their application data. This means that if an applicant completes your videoask application form but does not leave an email address, you will receive their responses in VideoAsk, but not in Greenhouse.

If an application leaves just an email address, but not their name, their candidate profile in Greenhouse will use this default information:

First name:¬†[email protected] (<First name unknown>)

Last name: (<Last name unknown>)

One final note: if an applicant uses the same email address to apply more than once to the same job posting via a videoask application, then the two candidate profiles will be merged in Greenhouse and their application data will be overwritten with the most recent submissions.

View your candidates

When an applicant fills out your videoask application form, you will see their answers in both your VideoAsk inbox:

2021-07-01_13-30-50.png

And a new candidate profile will be created in Greenhouse with the contact details they provided. Click View Application to see their answers in Greenhouse.

2021-07-01_13-31-24.png

In their Greenhouse application, you'll see the answers and files they submitted to the videoask questions you mapped out when setting up the integration:

2021-07-01_13-32-39.png

Any audio or video answers you have received will be transcribed so you can read their full application in Greenhouse.

In the applicant activity feed, a new note will be added any time you reply to an applicant using VideoAsk.

2021-07-01_14-04-11.png

Here you will also find a note linking to the applicant's original application in VideoAsk, should you wish to view it there:

2021-07-01_14-04-35.png

Edit the integration

1

From your videoask, click Connect

2021-06-22_18-19-55.png

2

Scroll down to Greenhouse and click Edit this integration

2021-07-01_12-25-27.png

3

Update the desired fields and click Finish

2021-07-01_12-27-29.png

Disconnect your videoask

If you'd like to stop sending responses from VideoAsk to Greenhouse, you can disconnect your form from the job posting at any time. This will not delete any information that has already been sent to Greenhouse, but it will immediately stop sending any new information from VideoAsk.

1

From your videoask, click Connect

2021-06-22_18-19-55.png

2

Scroll down to Greenhouse and click Disconnect

2021-07-01_12-28-25.png

Can't find what you're looking for?