SpringVerify has developed integrations with Ashby ATS, allowing clients to generate Ashby API keys directly from the Ashby platform. This integration helps streamline and automate background verification processes within the Ashby environment.

Section A: Steps to Generate an API Key on Ashby

Step 1: Navigate to Integrations

• Open the Ashby URL and log in to your account.
• Click on Admin.
• Select Integrations from the right-side menu

Step 2: Open API Keys

• Click on Integrations.
• Select API Keys.
  
  
  

Step 3: Create a New API Key

• Click New to create a new API key.

Step 4: Enter API Key Details

• Enter the name of the API key in the Name field.
• Click Create API Key.

Step 5: Configure API Scopes

• Select the following API scopes for the Candidates module:

• Read All
• Write All

• Click Save and Continue.

Step 6: Copy the API Key

• Copy the generated API key.
• Click Copy and Close.

• 
  
  
  Section B: Steps to Integrate Ashby with SpringVerify IN     
  
  Step 1: Open the SpringVerify Integration Page
• Navigate to the SpringVerify IN integrations page: https://portal.in.springverify.com/integrations
• Clients can view all available integrations along with the required setup steps.

Step 2: Connect the Ashby ATS Integration

• Search for the Ashby ATS integration card.
• Click Connect.

Step 3: Enter the API Key

• A modal window for Ashby integration will appear.
• Enter the API key created in Section A.
  
  
  Step 4: Complete the Connection

• Click Connect after entering the API key.

Step 5: Copy Integration Details

           After a successful connection, SpringVerify will display:

• External API Token
• Base URL

Copy both values as they will be required for webhook configuration in Ashby.

Step 6: Navigate to Integrations in Ashby

         In Ashby:

• Go to Admin → Integrations
• Locate the Springworks card from the integrations list.

 



Step 7: Configure the Springworks Integration

Fill in the following required fields:

Section C: Steps to Initiate Background Verification from Ashby

Step 1: Open the Job’s Interview Plan

• In Ashby, navigate to Jobs.
• Open the target job (e.g., QA).
• In the left sidebar under the ADMIN section, click Interview Plan.

Step 2: Add Activity at the Offer Stage

• Scroll to the Offer stage.
• Click Add Activity to Offer.
• Select + Add Activity from the dropdown.

Step 3: Select Springworks from Integrations

• In the Add Activity panel, scroll to the Integrations section.
• Select Springworks.

• Subtitle: Send assessments via Springworks

Step 4: Choose the Assessment Type

• The Add Springworks Activity modal will open.
• Select the Assessment Type from the dropdown.

This assessment type maps to the BGV package configured in SpringVerify.

Example:

• ID (Custom Verifier 6)

Step 5: Add the Activity

• Click Add to attach the Springworks activity to the Offer stage.

The Springworks Assessment activity is now configured.

Section D: Steps to Add a Candidate on Ashby and Trigger Initiation

Step 1: Add a Candidate

• Open the Ashby URL and log in.
• Click Add beside the search box.
• Select Candidate.

Step 2: Enter Candidate Details

Enter the mandatory information required to trigger initiation:

• Name
• Email Address
• Phone Number

Click Submit.

Step 3: Assign the Candidate to a Job

On the Consider Candidate for Job? screen:

• Select the target job (e.g., QA).
• Select the Interview Stage.
• Click Add to Job.

Step 4: Move the Candidate to the Offer Stage

• Open the candidate profile.
• Click Change Stage.
• Select Offer from the dropdown.

Step 5: Start the Springworks Assessment

• Once the candidate reaches the Offer stage, the Springworks Assessment activity will appear.
• Click Start Assessment.
• Confirm the Assessment Type in the popup.
• Click Start.

.

Step 6: Candidate Creation in SpringVerify

• The candidate profile will automatically be created in SpringVerify.
• You can directly open the profile from Ashby.

Step 7: Candidate Completes the BGV Form

• The candidate will receive an email containing the BGV form link.
• The candidate must open the link and submit the BGV form.

Once the form is submitted:

• The verification process will begin.
• After completion, the report link and status will be pushed back to Ashby automatically.

FAQ – SpringVerify Integration with Ashby ATS

1. What is the SpringVerify and Ashby ATS integration?

The integration allows users to initiate and manage background verification (BGV) processes directly from Ashby ATS using SpringVerify.

2. What is required to set up the integration?

You need:

• An active Ashby ATS account
• Access to Admin settings in Ashby
• A generated Ashby API Key
• Access to the SpringVerify integrations page

3. How do I generate an API key in Ashby?

Go to:

• Admin → Integrations → API Keys
• Click New
• Enter the API key name
• Select:

• Read All
• Write All

• Save and copy the generated API key

4. Where do I connect the Ashby integration in SpringVerify?

Navigate to:

• https://portal.in.springverify.com/integrations
• Search for Ashby ATS
• Click Connect
• Enter the Ashby API key

5. What details are provided after successful integration?

SpringVerify provides:

• External API Token
• Base URL

These details are required for configuring the integration inside Ashby.

6. Where should the External API Token and Base URL be added in Ashby?

In Ashby:

• Go to Admin → Integrations
• Open the Springworks integration card
• Enter:

• Springworks API Key → External API Token
• Staging Base URL → Base URL
• Ashby API Key → Previously created API key

7. How can background verification be triggered from Ashby?

Background verification can be triggered by:

• Moving the candidate to the Offer stage
• Starting the Springworks Assessment activity

8. How do I configure the Springworks Assessment activity?

Go to:

• Jobs → Interview Plan → Offer Stage
• Click Add Activity
• Select Springworks
• Choose the required assessment type
• Save the activity

9. What does the Assessment Type represent?

The Assessment Type maps to the BGV package configured in SpringVerify.

Example:

• ID (Custom Verifier 6)

10. What candidate details are mandatory for initiation?

The following fields are mandatory:

• Candidate Name
• Email Address
• Phone Number

11. When is the candidate created in SpringVerify?

The candidate profile is automatically created in SpringVerify once the assessment is started from Ashby.

12. How does the candidate receive the BGV form?

The candidate receives an email containing the BGV form link.

13. What happens after the candidate submits the BGV form?

Once submitted:

• The verification process begins
• Report status updates are pushed back to Ashby automatically

14. How frequently are report updates pushed back to Ashby?

Report updates are pushed back automatically after every hour.

15. Can users open the SpringVerify candidate profile directly from Ashby?

Yes, users can directly open the linked SpringVerify candidate profile from Ashby.

16. What should I do if the integration is not working?

Please verify:

• API key permissions
• Correct API token and Base URL
• Integration configuration in both Ashby and SpringVerify

If the issue persists, contact the SpringVerify support team.