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 a take-home assignment 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#

  1. Generate your EasyEnv key
    In EasyEnv, open your account and go to Integrations. 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.
  2. 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.
  3. Paste the Ashby key into EasyEnv
    Back in EasyEnv, on the Ashby card, paste it under Ashby API key and click Save. The card shows the last four characters once it is saved.
  4. 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.

The Ashby tile says Connected once both keys are in place. Until Ashby first calls EasyEnv with your key, for example when you add EasyEnv to an interview plan below, the card also says Ashby has not called EasyEnv with this key yet. If you generate a new EasyEnv key, that line comes back until Ashby has the new one.

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#

  1. 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.
  2. When a candidate reaches that stage, start the assessment from Ashby.
  3. EasyEnv emails the candidate their invitation right away. They have 7 days to start it by default; change that on the Ashby card under EasyEnv integrations.
  4. The interview appears in EasyEnv under that role like any other take-home assignment, 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#

FieldTypeDescription
InvitedThe candidate has been emailed and has not started yet. Ashby also shows when the invitation expires.
StartedThe candidate is taking the interview. Ashby records the start time.
SubmittedThe candidate has finished. It is waiting for your team to review it in EasyEnv.
CompletedSomeone on your team passed or failed the candidate in EasyEnv. Ashby shows it as the result.
Cancelled: ExpiredThe 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 under EasyEnv integrations. It says Needs attention when the last update failed, and 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.
Send EasyEnv assessments from Ashby | Docs | EasyEnv