SpringVerify & TeamTailor ATS Integration – Setup & BGV Guide

Integration of SpringVerify with TeamTailor ATS

Overview




This guide is for HR users and hiring managers who use TeamTailor as their Applicant Tracking System (ATS) and have the SpringVerify Background Verification (BGV) integration enabled.

Once the integration is set up by your admin, you do not need to manually initiate background checks. The process is fully automated — this guide explains what happens, what you need to do in TeamTailor, and how to track verification progress.

How the Integration Works

The integration between TeamTailor and SpringVerify is fully automated. Here is the end-to-end flow:


1

HR / Hiring Manager

Assign the required BGV package and move the candidate to the trigger stage in TeamTailor (e.g., Hired).

2

System (Automatic)

Cron will run every hour and SpringVerify receives candidate details and creates a BGV profile.

3

System (Automatic)

The candidate receives a BGV form link via email and is asked to fill in their details.

4

Candidate

The candidate completes the BGV form on SpringVerify's portal, uploading required documents.

5

SpringVerify

Background checks begin. Each check runs independently (identity, employment, education, address).

6

System (Automatic)

As checks complete, SpringVerify pushes interim status updates and report links back to TeamTailor.

7

HR / Hiring Manager

View the BGV status and report link directly in the candidate's TeamTailor profile.


 Integration Setup

The following settings are used when configuring the TeamTailor integration in SpringVerify. Your admin will have set these during initial setup.


Field

Value

Notes

API Base URL

https://api.teamtailor.com/v1

Fixed

Candidate Status Filter

Hired

Options: Hired, In process, Inbox

Package Source

Custom Field / Tag

Uses BGV_PACKAGE as value in custom field and BGV: in Tag

BGV Package Custom Field Name

BGV_PACKAGE

Must match TeamTailor exactly

Country Filter

India

Leave empty for all countries

Push Report to TeamTailor

Enabled

Requires Partner API Key


Step 1 — Navigate to SpringVerify Integrations Page

Go to the SpringVerify SA portal → click your name at the top right → select Integrations → search for TeamTailor → click Connect.


Fig 1.1 — SpringVerify portal: finding the TeamTailor integration




Step 2 — Integration Form: Set Package Source

Open the TeamTailor integration config. By default some fields are already populated — you can proceed with defaults or update as required.




Step 3 — Create an API Key in TeamTailor

In TeamTailor go to Settings → Integrations → API Keys. Click New API Key. Name it (e.g. SpringVerify Integration), set Scope to Admin, enable Read access, then click Create.




Step 4 — Enter API Credentials in SpringVerify

Paste the TeamTailor API key. Set API Base URL to https://api.teamtailor.com/v1 and set Candidate Status Filter to Hired.



Step 5 — Set Country Filter and Confirm Custom Field Name

Set the Country Filter to India (or leave blank for all countries). Confirm that BGV_PACKAGE matches exactly the custom field name in TeamTailor.




Step 6 — Enable Push Report and Enter Partner API Key

Check the Push report to TeamTailor checkbox. Enter the Bearer token from the TeamTailor Integration Hub as the Partner API Key. Optionally enable interim report pushes.






Step 7 — Final Review and Click Connect

Review all fields in the form. Once satisfied, click Connect to complete the TeamTailor integration setup.




How to Initiate BGV from TeamTailor


STEP

1

Assign a BGV Package to the Candidate

Do this before moving the candidate to the trigger stage


Before moving a candidate to the hiring stage that triggers BGV (e.g., Hired), ensure the correct BGV package is assigned. This tells SpringVerify which set of background checks to run.


Option A — Using a Tag

Add a tag to the candidate in TeamTailor using the format below. The package name must exactly match the Subtype/Friendly name shown on the SpringVerify Portal.


bgv:<subtype-name/friendly name>


Examples:


Tag

BGV Package Assigned

bgv:standard

Standard background check package

bgv:executive

Executive-level background check package


1

Open the candidate's profile in TeamTailor.

2

Click on the Tags field on the candidate profile.

3

Type the tag in the format bgv:<subtype-name/Friendly Name> and press Enter. Use the exact package name as shown on the SpringVerify Portal.

4

Confirm the tag appears on the candidate profile before proceeding.


💡  Tip — Not sure which package to use?

Ask your SpringVerify CSA/CSM for the list of available package names and when to use each one.


Option B — Using a Custom Field

If your organisation uses a custom field as the package source, the field must exist in TeamTailor and exactly match the field name configured in SpringVerify.


1

Open the candidate's profile in TeamTailor.

2

Locate the custom BGV Package field (set up by your admin).

3

Select the correct package name from the available options.

4

Save the candidate profile before moving to the next step.


STEP

2

Move the Candidate to the Trigger Stage

This starts the BGV process automatically


Once the BGV package is assigned, move the candidate to the stage configured to trigger background verification. This is typically the Hired stage, but your admin may have configured a different stage.


1

Open the candidate's profile or pipeline view in TeamTailor.

2

Move the candidate to the trigger stage (e.g., Hired) — drag-and-drop in pipeline view, or use the stage selector on the candidate profile.

3

The integration will automatically send the candidate's details to SpringVerify. No further action is needed from you at this point.


ℹ  Note — What gets sent to SpringVerify?

SpringVerify receives the candidate's name, email address, phone number, and the BGV package identifier. The candidate will then be asked to fill in the remaining details themselves via the BGV form.


✓  You're done!

Once the candidate is moved to the trigger stage with the correct package tag or custom field in place, SpringVerify takes over. The candidate will receive an email with their BGV form link.


STEP

3

What the Candidate Experiences

The candidate's side of the process


After the integration triggers, the candidate receives an automated email from SpringVerify with a link to their BGV form. Here is what they will need to do:


#

Step

Details

1

Receive email

The candidate receives an email from SpringVerify with a secure link to their BGV form.

2

Fill in personal details

Name, date of birth, father's name, contact details, and other basic information.

3

Employment history

Past employer names, designations, joining and leaving dates, HR contacts, manager details.

4

Education details

Institution name, course, registration number, dates, and supporting documents.

5

Address details

Current and permanent address, duration of stay, and address proof documents.

6

Upload identity documents

PAN, Aadhaar, Passport, Driving Licence, or Voter ID as required by the package.

7

Submit the form

Once all details are filled in and documents uploaded, the candidate submits the form.


💡  Tip — Candidate not received the email?

Ask the candidate to check their spam or junk folder. If still not found, resend the BGV form link from the SpringVerify portal.


STEP

4

Track BGV Status in TeamTailor

No need to log into SpringVerify


You can monitor BGV progress directly from the candidate's profile in TeamTailor. If your admin has enabled Push Interim Report and Push Report, status updates and a report link will appear automatically.


Where to Find the BGV Status

1

Open the candidate's profile in TeamTailor.

2

Scroll down on the candidate page — you will see the SpringVerify Webhook section showing the current BGV status and report link.

3

You will see the current BGV status and, once available, a link to view the full report.


Fig 10 — SpringVerify status and report link on the candidate profile in TeamTailor


STEP

5

Viewing the BGV Report

Final and interim reports in TeamTailor


When SpringVerify has completed individual checks or the full verification, a report link will automatically appear on the candidate profile in TeamTailor.


Interim Report

Final Report

Appears as each individual check completes — before the full BGV is done. Useful for early visibility on key checks like identity or employment.

Appears once all checks in the package are complete. Contains the full verification outcome with details of each check.


1

Go to the candidate's profile in TeamTailor.

2

Locate the SpringVerify report link — it may appear as a URL or a clickable button labelled View Report.

3

Click the link to open the SpringVerify report in your browser. You may be asked to log in to SpringVerify to view the full report.


Fig 11 — Report link visible on the candidate profile in TeamTailor


ℹ  Note — Report not visible yet?

If the Push Report or Push Interim Report checkboxes were not enabled during setup, the report link will not appear in TeamTailor. Contact your admin to enable these options in the integration settings.



Important Notes
  • BGV Package Custom Field Name/Tag Name must exactly match the Teamtailor custom field name/Tag Name (case-sensitive).
  • Partner API Key is required when Push report to TeamTailor is enabled — get it from the TeamTailor Integration Hub.
  • Only candidates in the Candidate Status Filter stage are synced.
  • Country Filter restricts sync to jobs in the specified country.
FAQ – SpringVerify × TeamTailor Integration
1. What is the SpringVerify and TeamTailor integration?
The integration enables automatic background verification (BGV) initiation and tracking directly from TeamTailor ATS using SpringVerify.

2. Is manual BGV initiation required after setup?
No. Once the integration is configured, the process is fully automated when the candidate reaches the configured trigger stage.

3. How does the integration workflow operate?
The process works as follows:
  1. Candidate is moved to the configured trigger stage.
  2. SpringVerify automatically receives candidate details.
  3. Candidate receives the BGV form email.
  4. Candidate submits details and documents.
  5. Verification checks begin.
  6. Status updates and report links are pushed back to TeamTailor.

4. How frequently does the integration sync candidates?
The integration cron runs every hour and syncs eligible candidates automatically.

5. Which candidate stages can be configured for synchronization?
Supported Candidate Status Filter options include:
  • Hired
  • In Process
  • Inbox

6. What is the default API Base URL for TeamTailor integration?
Use the following API Base URL:
https://api.teamtailor.com/v1

7. How do I create a TeamTailor API Key?
In TeamTailor:
  • Go to Settings → Integrations → API Keys
  • Click New API Key
  • Set Scope to Admin
  • Enable Read/write Access
  • Create and copy the API key

8. What permissions are required for the TeamTailor API Key?
The API Key should have:
  • Admin Scope
  • Read/Write Access enabled

9. What is the purpose of the Candidate Status Filter?
The Candidate Status Filter determines which candidate stage triggers synchronization with SpringVerify.

10. How can a BGV package be assigned to a candidate?
A BGV package can be assigned using:
  • Tags
  • Custom Fields

11. What is the correct format for BGV tags?
The tag must follow this format:
bgv:<subtype-name/friendly name>
Example:
  • bgv:standard
  • bgv:executive

12. Does the package name need to exactly match SpringVerify?
Yes. The package name must exactly match the Subtype/Friendly Name configured in SpringVerify.

13. What is the BGV_PACKAGE custom field?
BGV_PACKAGE is the custom field used to define which background verification package should be initiated for the candidate.

14. Is the BGV custom field name case-sensitive?
Yes. Both the custom field name and tag name are case-sensitive and must exactly match the configured value in SpringVerify.

15. What candidate details are sent to SpringVerify?
The following details are shared automatically:
  • Candidate Name
  • Email Address
  • Phone Number
  • BGV Package Identifier

16. What happens after the candidate reaches the trigger stage?
SpringVerify:
  • Creates the candidate profile
  • Sends the BGV form link
  • Begins the verification process after form submission

17. How does the candidate receive the BGV form?
The candidate receives an automated email from SpringVerify containing a secure BGV form link.

18. What information does the candidate need to provide?
The candidate may need to submit:
  • Personal details
  • Employment history
  • Education details
  • Address details
  • Identity documents

19. Which identity documents may be required?
Depending on the BGV package, candidates may upload:
  • PAN Card
  • Aadhaar Card
  • Passport
  • Driving Licence
  • Voter ID

20. What should be done if the candidate does not receive the BGV email?
Ask the candidate to:
  • Check Spam/Junk folders
  • Contact the HR/Admin team to resend the BGV form link

21. Can HR users track BGV progress directly in TeamTailor?
Yes. HR users can view:
  • Current verification status
  • Interim reports
  • Final reports
directly from the candidate profile.

22. Where can the BGV status be viewed in TeamTailor?
The status is available in the SpringVerify Webhook section on the candidate profile page.

23. What is the difference between Interim and Final Reports?
Interim Report
  • Shared while checks are still in progress
  • Helps track partial verification progress
Final Report
  • Shared once all checks are completed
  • Contains the final verification outcome

24. What is required for report push functionality?
The following are required:
  • Push Report to TeamTailor enabled
  • Valid Partner API Key configured

25. What is the Partner API Key?
The Partner API Key is a bearer token obtained from the TeamTailor Integration Hub and is required for pushing reports back to TeamTailor.

26. What should I do if the report link is not visible?
Please verify:
  • Push Report option is enabled
  • Push Interim Report option is enabled
  • Partner API Key is configured correctly

27. Does the Country Filter restrict synchronization?
Yes. Only jobs matching the configured country filter are synchronized with SpringVerify.

28. Is the Country Filter mandatory?
No. Leave the field blank if synchronization should work for all countries.

29. Can interim status updates be disabled?
Yes. Push Interim Report can be enabled or disabled during integration setup.

30. Do HR users need to log in to SpringVerify to track status?
No. Verification status and report links are available directly inside TeamTailor.

    • Related Articles

    • Integration of SpringVerify with Ashby ATS

      Overview 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 ...

    • SpringVerify API Integration Guide for HRMS/ATS

      1. Introduction This document provides comprehensive technical guidance for integrating the SpringVerify Background Verification (BGV) platform with your HRMS (Human Resource Management System) or ATS (Applicant Tracking System). The integration ...

    • Integration of SpringVerify with Recruitee

      Overview: This guide provides step-by-step instructions for integrating SpringVerify with Recruitee, allowing you to perform background checks on candidates within the Recruitee platform. Prerequisites: Access to the SpringVerify Access to the ...

    • Integration of SpringVerify with Teamtailor

      Overview: SpringVerify IN has developed integrations with Teamtailor, enabling clients to use the API Key and API base URL from the Teamtailor platform. This integration facilitates a streamlined and automated approach to conducting background ...

    • Pre-Offer BGV Setup Guide | Darwinbox & SpringVerify Integration

      Overview This guide helps you set up and use Pre-Offer Background Verification with SpringVerify directly from your Darwinbox Recruitment module. With this integration, you can initiate background checks on candidates before making an offer—all ...