Astronaut is an easy-to-use video interview platform and assessment tool that makes the hiring process fast, accurate, collaborative and enjoyable for everyone involved.

Astronaut helps candidates to engage in job interviews and assessments 24/7 from any device and results can be shared seamlessly with peers for collaboration and approvals at any time, anywhere. 

Greenhouse Recruiting's integration with Astronaut allows you to seamlessly add Astronaut’s assessment to a job’s interview plan.

Set up the Astronaut integration

Create a Harvest API key

To configure the Astronaut integration, you’ll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Astronaut integration.


In the Create New Credential window, make the following selections:

  • API Type: Harvest
  • Partner: Astronaut (optional)
  • Description: Astronaut Harvest API key


Verify that the following permissions are selected for the Astronaut integration:


  • Select all


  • Select all


  • Select all

When finished, click Save

Your Harvest API key for the Astronaut integration is created and configured. 

Register with Astronaut and collect your Astronaut API key

Next, you'll need to collect your API key provided by Astronaut.

If you already have an Astronaut account, navigate to Astronaut and Log in.

If you haven't registered to Astronaut, click here or send an email to to express your interest in using the Greenhouse Recruiting/Astronaut integration.

Note: If you already have a Harvest API key through Astronaut, we will give you instructions on how to send your Harvest API key safely. 

After registering to Astronaut, you’ll see your Astronaut Dashboard to retrieve your API key. 

Select Account Settings in the top right corner and choose Organization Details.

You’ll see your Astronaut API key on the Organization Details page. You’ll need this API key to complete the next steps.

Copy the API key to provide to Greenhouse Recruiting in the next step. 

Provide your Astronaut API credentials to Greenhouse Recruiting 

Once you have received your Astronaut API key, click here to open a ticket with Greenhouse.

If you're logged in to your Greenhouse account, you can also click the Get help widget in the bottom left corner of the page.

Note: Do not send your API key in unencrypted communication, such as email and support tickets. If they are needed for setup, Greenhouse Technical Support will provide a secure way to send your API keys. Wait for a confirmation email from Greenhouse Technical Support. You may be required to verify your account before you can proceed.

The Greenhouse Technical Support team will provide a SendSafely link where you can enter your API key. Once Greenhouse Technical Support has been notified that you’ve entered your API key, they will send a confirmation email.  

Configure the Astronaut assessment and complete setup 

After enabling the Astronaut integration, you'll be able to set up interview questions/templates to be sent to candidates. 

To create a new Astronaut test/assessment template, navigate to Astronaut and Log in. Then, click on the Assessment Library tab.

With the Assessment Library template, you can:

  • Create, edit and delete a video question
  • Create, edit and delete a free-text question
  • Create, edit and delete a multiple-choice question
  • Create, edit and delete a template

To create, edit and delete your Astronaut question template, click on the Template tab.

To create a new template, click the Add Template button.

The Add Template window will show. Here, you can add and edit:

  • Template name
  • Template description
  • Dynamic Deadline: How many days (after the candidate received an invitation to complete the Astronaut assignment) that the candidate can complete the Astronaut Q&A session before the it becomes unavailable.
  • Make this available to others (Leave it on “No” if you don’t want this template to be accessible to other Astronaut users)
  • Scoring method (Leave it on “Manual”)

Click Add to create a blank template.

After a blank template is created, you can add questions by choosing the video/free-text/multiple-choice tab. You can also use Sections to combine video, free-text and multiple-choice in one template.

After you choose the questions that you want to put into the template, they will be added to the template.

Click Update Template if you are satisfied with your template settings.

Click Update to finalize your new choices.

Note: All templates that contain questions will appear in Greenhouse Recruiting when you choose which Astronaut template assessment to send to candidates.

Use the Astronaut integration with Greenhouse Recruiting

Add Astronaut stage to an interview plan

Once the Greenhouse Recruiting/Astronaut integration is enabled for your organization, you will be able to add the Astronaut assessment as an interview stage

To add a stage to an existing job, navigate to a job (Jobs > Job Name) and click Job Setup

Select Interview Plan on the left side of the page and then, click +Add a Stage.

From the listed stage options, select the Astronaut stage.

When finished, click Add to apply the Astronaut stage to the job's interview plan.

Set up the assessment in the Astronaut stage

After the stage has been added to the job's interview plan, you’ll need to choose the assessment for the stage. To choose the assessment, click Edit Take Home Test

Choose the assessments from the dropdown menu. These options are based on the assessments you configured in Astronaut. 

Assign at least one Greenhouse Recruiting user to grade/review submitted assessments. When you’re finished, click Save.

Note: All configurations of the assessment, including the email template, will need to be done in Astronaut.

Send and review a test

When candidates are moved into the Astronaut interview stage, Greenhouse will display a Send Test link.

Note: When you send a partner assessment from inside Greenhouse Recruiting, the interview instructions will still be sent by Astronaut.

You can choose which test/assessment template that you already set up in the Astronaut recruiter dashboard.

After it has been sent, the assessment’s status will display in Greenhouse Recruiting. 

The candidate will receive an invitation email from Astronaut to complete the Astronaut interview session.

The candidate will then click Start Q&A Session to proceed.

Once the candidate has submitted their test, the Interview Kit in Greenhouse will contain a link to view the submitted test in the Astronaut application.

Click the Astronaut stage to see the candidate's results. Click View Report to see the candidate’s results in the Astronaut recruiter dashboard.  

You will be redirected to the Astronaut recruiter page to see the candidate’s test results.

Additional resources

Please contact for troubleshooting assistance regarding the integration.