This guide will walk you through integrating your SHL account with Ashby, allowing you to use SHL assessments in your interview plans and retrieve the results all from within the Ashby platform.

Customers should first engage with SHL to scope the integration and execute the required Statement of Work (SOW) before following the steps below. An implementation fee may apply depending on the engagement.

Client credentials (Client ID and Client Secret) are provisioned only after the SOW has been signed and the implementation project has commenced.

Select the way you’d like to add assessments to candidate profiles (see 

 (you may need to get in touch with SHL for this)

Generate an Ashby API Key (more on this at 

If you’re not an partner, please ignore the staging base URL field

Adding background check requests as a one-off

 to generate an SHL activity. Then, follow the steps on the activity that appears.

Visit the settings of a job and add the activity to the reference check stage of your interview plan. When a candidate enters the stage the activity will appear you can manually complete the steps to send the request, or when the card

Automatically adding the assessment to offer or hired stages

Choose the stage you’d like to include the activity on while configuring the integration. When a candidate enters the designated stage, the corresponding activity will appear.

When the package has been completed, the activity's status will be updated. The hiring team will receive notifications as the status changes.

There will be a link to the results on the activity upon completion.

What permissions does the Ashby API Key need?

The SHL integration would require read/write access for candidates on the Ashby API key. These permissions are pre-defined and don’t need to be modified.

RepScout

The openings feature in Ashby lets you track your open headcount and hiring goals as well as metrics for each individual headcount accurately. You can assign multiple openings to a single job.

Openings

Adding your data from your previous ATS to Ashby

migration

Schedule interview activities can be set up within each stage of your job’s interview plan. These activities allow you to select an interview type, interviewers and set the interview’s settings in advance.

schedule_interview_activities

The candidate’s application or consideration for a role. A candidate can have multiple job considerations on their profile, as you can consider a candidate for as many roles as you’d like.

job_considerations

A job board that can only be accessed by users logged into Ashby. The job board or boards your jobs are posted to are selected within the job posting settings.

internal_job_board

Set within a job’s Settings section, users added here will receive notifications about the role they’ve been assigned to. The types of notifications they receive will be based on their Notifications settings within Personal Settings. 

hiring_team

Determine if and when users can view feedback based on their access role. 

feedback_visibility

The users in your Ashby account. Employees can be provisioned automatically via the Google Workspace or Microsoft 365 integration or be added manually. They will be provisioned with Limited Access permissions initially.

employees

Settings to determine if emails sent to and from the candidate are hidden when in the Offer or Hired stages. Can also skip email syncing for hired candidates and for those considered for confidential jobs.

email_visibility

A survey with set wording and questions that candidates can fill out voluntarily. This survey can be added to the application tab of your job postings, be sent out manually or you can create automation rules to send it out automatically.

EEOC_Survey

Reports that are sent to you regularly with information about upcoming interviews or overdue tasks. Can be set up in Personal Settings > Notifications.

digests

The color palette used for all reports and dashboards. The chosen color customization will be applied across the organization for all users.

default_visualization_colors

Dashboards allow you to add multiple reports to one page for easy viewing. You can also add filters to dashboards and link them to each report to filter all reports down without amending each of them individually.

dashboards

Links that you can add to external job board postings to automatically add a specific source to a candidate’s application.

custom_tracking_link

- 
    
A feedback form that was created specifically as part of an interview. Cannot be used on other interviews unless it’s promoted to a shared feedback form.

custom_feedback_form

An interview that was created specifically as part of a schedule interview activity. Cannot be used on other jobs or interview plans unless it’s promoted to a shared interview. 

custom_interview

An application form that was created specifically within a job posting. Cannot be used on other jobs or job postings unless it’s promoted to a shared application form. 

custom_application_form

Allow you to create fields to store additional information for candidates, jobs, projects or offers.

custom_fields

The option to remap data into custom buckets for reporting purposes.

calculated_fields

A tool to set rules that will automatically reject an application based on answers to specific questions within the application form.

auto-reject

A tool that allows you to set up a process where one or multiple users must approve an offer, a job or an opening before further action can be taken.

approvals

The form that a candidate completes on your job board when applying for a role. Once the application form is submitted, the candidate will appear in the Application Review section of your job’s pipeline.

application_form

The tool used to configure an email that is automatically sent to a candidate after their application has been submitted.

application_email_confirmation

Removing candidate’s PII from their profile but keeping other information for reporting purposes (pipeline movement, job considerations, etc).

anonymizing_candidates

Clarifying internally why a candidate has been rejected for a role.

archive_reasons

The option to add specify a number of minutes to be blocked off before and after interviews to avoid back-to-back interviews.

buffer

The ID number added to a job for reference purposes. Can be replaced by opening ID if you opt to use openings.

requisition_ID

Any user with access to Ashby can log in and either submit a referral directly or generate a link to share with their community. A candidate who applies via that link will be credited to that user. 

referrals

Where you can set default settings like Location and calendar invite content for interviews and schedule interview activities.

scheduling_defaults

Part of the Google Workspace and Microsoft 365 integrations where users are synced over and given access to Ashby automatically. Users are provisioned with Limited Access by default.

user_sync

The option to add a send-as email address in Gmail and share it with other users. You can also specify a default no-reply address for automated emails. 

shared_email_aliases

Tokens you can add to your sequences and email templates to pull information from the candidate’s profile, from the sender or from the job. This information is then added to the email automatically in place of the token when sending an email.

substitution_tokens

The option to share your email address with others and for others to share theirs with you. Once shared, emails can be sent on another user’s behalf.

email_sharing

A route to import or bulk update candidates, openings or employees by uploading a CSV file. The file can be uploaded and field can be mapped accordingly at Admin > Data Management > Bulk Data Import.

bulk_CSV_import

A route to import candidates by emailing their resumes or CVs over to a candidate upload email address. The email addresses you can use to import candidates can be found in Admin > Data Management > Import via Email.

email_import

Drip campaigns that you can enrol leads or candidates in to gauge their interest in a role.


sequences

Projects are lists of leads or potential candidates. They help you keep track of talent that you're not actively considering for any particular role you currently have open.

projects

The stage the role you’ve created is currently at. The job can either be a draft, open (accepting candidates and/or moving them through the pipeline currently), closed (candidates are no longer being considered) or archived.

job_status

Moving a candidate’s job consideration to another job’s pipeline. This option is available in the ‘More’ section of the candidate’s profile.

transfer

Tasks are shown on your Home page and are any actions that need to be taken (leaving feedback, following up with a candidate, approving an offer, opening, or job, or acknowledging a note you’ve been tagged in)

tasks

Where you can set a rule to stop candidates from being enrolled in a sequence if they have been contacted already within a certain time frame.

Outreach_Frequency_Policy

The final result for an application, either Hired or Archived.

outcome

Where you can see all of the integrations we currently offer. Don’t see the integration you’re looking for? Reach out to support@ashbyhq.com to put in a request.

Integrations_Marketplace

Job_Consideration

Rejecting a candidate's job consideration