Send EasyEnv assessments from Ashby

Connect Ashby to EasyEnv so recruiters can send an EasyEnv role to a candidate from an Ashby interview plan, and see the outcome on the candidate in Ashby.

How it works#

Your EasyEnv roles show up in Ashby as assessments. A recruiter adds one to a job's interview plan, and when a candidate reaches that stage, Ashby asks EasyEnv to invite them. EasyEnv emails the candidate an offline interview for that role. As the candidate starts, submits and gets reviewed, EasyEnv reports each step back to the candidate in Ashby, with a link to the full interview in EasyEnv.

Two keys make this work, one for each direction, and you set up both in a few minutes:

Your EasyEnv key goes into Ashby. Ashby uses it to list your roles and to send candidates to EasyEnv.
Your Ashby API key is created in Ashby for the Easyenv integration and goes into EasyEnv. EasyEnv uses it to send progress and results back to Ashby.

Before you start#

You need to be an owner or admin of your EasyEnv account.
You need to be an Ashby admin, to enable integrations and create API keys.
Your EasyEnv account needs an active interview plan. Every assessment sent from Ashby counts as one interview, the same as one you send from EasyEnv.
At least one role in EasyEnv. Only active roles that are not archived are offered to Ashby.

Connect Ashby#

Generate your EasyEnv key
In EasyEnv, open Settings, find the Ashby card and click Generate EasyEnv key. Copy the key straight away: EasyEnv shows it once and never again. If you lose it, generate a new one; the old one stops working at that moment.
Create an Ashby API key for Easyenv
In Ashby, go to Admin, Integrations, API Keys and click New. Name it, choose Easyenv as the Integration Partner, and give it write access to Candidates. Create it and copy the key: Ashby shows it once.
Paste the Ashby key into EasyEnv
Back in EasyEnv, on the Ashby card, paste it under Your Ashby API key and click Save. The card shows the last four characters once it is saved.
Enable Easyenv in Ashby
In Ashby, go to Admin, Integrations, find Easyenv and click Enable Easyenv. Paste your EasyEnv key into Easyenv API Key, choose the key you created for Easyenv under Ashby API Key, and leave Staging Base URL empty.

Create the Ashby key for the Easyenv integration

Pick Easyenv as the Integration Partner when you create the Ashby API key, and choose that same key when you enable Easyenv. That ties the key to this integration. A generic key created without it may not be allowed to update your candidates, and EasyEnv would then be unable to report results.

Send an assessment#

In Ashby, open the job and its interview plan. On the stage where you want the assessment, add an activity, choose Easyenv from the integrations, and pick the EasyEnv role to use.
When a candidate reaches that stage, start the assessment from Ashby.
EasyEnv emails the candidate their invitation right away. They have 7 days to start it by default; change that on the Ashby card in EasyEnv settings.
The interview appears in EasyEnv under that role like any other offline interview, and you review it there as usual. See Review submissions.

Members of the job's hiring team in Ashby who are also members of your EasyEnv account are added to the interview as interviewers.

What Ashby shows#

Field	Type	Description
Invited		The candidate has been emailed and has not started yet. Ashby also shows when the invitation expires.
Started		The candidate is taking the interview. Ashby records the start time.
Submitted		The candidate has finished. It is waiting for your team to review it in EasyEnv.
Completed		Someone on your team accepted or rejected the candidate in EasyEnv. Ashby shows it as the result, passed for accepted and failed for rejected.
Cancelled: Expired		The candidate never started and the invitation window closed.

Alongside the status, Ashby shows a link to the interview in EasyEnv, the time the candidate spent, the score on automatically graded questions, and a summary of the AI review, as each of them becomes available.

The result is your decision

EasyEnv reports a result to Ashby only when someone on your team accepts or rejects the candidate on the review page. Until then the assessment stays at Submitted in Ashby.

Cancelling from Ashby#

Cancelling the assessment in Ashby closes the invitation in EasyEnv, so the candidate can no longer start. If they are in the middle of it, the session is stopped and what they did so far stays available for review. You can then start a new assessment for the same candidate from Ashby.

Troubleshooting#

Ashby says the EasyEnv key is unknown. The key was mistyped, or a newer one was generated since. Generate a new key in EasyEnv and paste it into the Easyenv integration in Ashby again.
Results do not reach Ashby. Check the Ashby card in EasyEnv settings. It shows whether your Ashby API key is saved and the last error Ashby returned. Most often the Ashby key was created without Easyenv as its Integration Partner; create one with it and save it again.
Ashby says to use a different candidate email. That email belongs to a member of your EasyEnv account, and a member cannot also be a candidate on the same account.
Ashby says the interview plan is not active. Renew the interview plan on your EasyEnv account, then start the assessment again.