Skip to main content
Ashby Integration Setup Instructions
Andrew Olsen avatar
Written by Andrew Olsen
Updated over a week ago

How the Integration Works

Here is a quick video from Searchlight CEO, Kerry Wang, on how the integration between Ashby and Searchlight makes running references easy and valuable. Saving your team time and providing them more signal.

Customizing your Searchlight Assessment

💡 In Searchlight, Assessments are the requirements a candidate must fulfill to complete their reference process, such as:

  • Inviting a certain number of references

  • Inviting specific references of a certain type (e.g manager, supervisor)

  • Which survey to use

  1. Head to your Company Settings in Searchlight

  2. Navigate to the ATS Settings tab, and at the bottom of the page you will see a table of your Assessments

  3. Click 'Add Assessment' to create your new Assessment

  4. Give your Assessment a name. This will correspond to the Assessment Type you select in Ashby

  5. Choose the total number of days that a candidate and their references will have to provide feedback.

  6. Select the survey the references will receive for this Assessment.

    1. You can select the Searchlight Gold Standard or a survey that we’ve customized for you. Searchlight’s survey questions are completely customizable.

  7. (If you’ve enabled candidate self-assessments in Searchlight) Select the survey the candidate will be asked to complete for this Assessment.

  8. Select the type and number of references you want for this Assessment

  9. Click OK to save your Assessment!

  10. Repeat the previous steps for any number of Assessments. At a minimum, create one Assessment that works across all job types and functions

💡 Pro tip: Most partners have 1 default Assessment. Some create custom Assessments per function and distinguish between Individual Contributor and Management roles.

Enabling the Ashby Integration on Searchlight

  1. First, get your Ashby API Key

    1. In Ashby, navigate to Admin > Ashby API (left hand menu) > API Keys and click 'Create One' Here is an example

    2. Name it something recognizable that makes it clear it is used with Searchlight, like "API Key for Searchlight"

    3. Select "Searchlight" as an Integration Partner

    4. Click 'Create API Key'

      1. 💡 Copy the API Key, and be sure to keep the key somewhere safe! You will need it for the next step

  2. In Searchlight, navigate to Company Settings (left hand menu) > ATS Settings

  3. Select Ashby from the list

    1. Provide the API key generated in the previous step under “Ashby API Key”

    2. Select which teams will be given access to Searchlight, and which teams will additionally receive notifications when an Assessment is completed

    3. Click 'OK' to finish adding the integration!

  4. You will then see your Ashby Integration settings

  5. Copy the Searchlight Api Key to share with Ashby

  6. In Ashby, navigate to Admin > Integrations (left hand menu) > Assessments and click 'Add Integration' and select Searchlight

  7. Add in the Searchlight Api Key you copied from Searchlight, and select the API key you created in Ashby under Ashby API Key

  8. You're now ready to Searchlight a candidate!

Searchlight-ing a Candidate from Ashby

You can now easily send a Searchlight assessment to your candidates as they navigate through the interview process!

  1. Add a Searchlight Assessment to the interview plan of a specific Job

    1. Navigate to the job you want to add a Searchlight Assessment to

    2. Select Interview Plans (left hand menu) and click “+ Activity” to add a Searchlight assessment to the desired stage

    3. Select Searchlight under integrations and select the assessment type you want to add under this stage (this assessment type corresponds to the Assessment you made earlier in Searchlight)

  2. When your candidate for the job enters the stage you added the assessment to, you will see the option to start the assessment

  3. Click ‘Start Assessment’ to send an email invite to your candidate to join Searchlight and begin the reference process

  4. When the candidate has accepted the Searchlight invite, you will see the status of the assessment updated to 'Started'

  5. When the candidate’s references have all been completed, you will see the status of the assessment update to 'Completed'

Viewing Searchlight data from Ashby

To view the Searchlight reference report for a candidate from Ashby, navigate to the candidate on Ashby. In the assessment section, follow the link under the 'Searchlight Candidate Data Link' field to be sent to the Candidate's Candidate Hub on Searchlight

Did this answer your question?