Darwinbox & SpringVerify Integration Flows | Configuration Guide

Darwinbox Integration Flows & Configuration Options

DarwinBox can hand candidates to SpringVerify at two different points in the hiring journey — before the offer (Recruitment) and after offer acceptance (Onboarding). This article walks through every way the integration can be set up, and exactly when verification starts, what reports flow back, and what needs configuring.

In one line: Wherever the case begins, candidate details flow to SpringVerify automatically, verification runs, and the final report is delivered into the Verification Reports section of the onboarding form — where your team already works.

01  Three Ways to Run the Integration

Recruitment and Onboarding are independent modules. Use either on its own, or both together for a full pre-offer-to-joining journey.

Module What it does Best when
Module A — Recruitment only DarwinBox acts as your ATS. A quick pre-BGV check runs before the offer letter is released, so you have a signal early. You want a fast, early check during hiring and don’t run onboarding in DarwinBox.
Module B — Onboarding only Candidates enter after they accept the offer. The full background verification runs before joining, with reports inside the onboarding form. Verification belongs in onboarding and hiring happens outside DarwinBox.
Module A + B — Recruitment + Onboarding A quick pre-offer check in Recruitment, then the same case carries seamlessly into Onboarding for the full verification — no re-entry, no duplicate. You want both an early signal and the complete verification on record.

02  The Complete Flow

Every path a candidate can take, from where the case starts to the final report. Follow whichever lane matches your setup — or both, when running Recruitment + Onboarding together.

🧲 Recruitment · Before the Offer

  1. Recruiter triggers BGV for the candidate in DarwinBox Recruitment.
  2. DarwinBox instantly sends the candidate’s details to SpringVerify — only the fields allowed by the verification package.
  3. Pre-BGV form enabled? (optional) — If enabled, DarwinBox sends the candidate a short form to collect extra details first. Pre-offer must be completed before Pre-BGV is initiated.
  4. Candidate created in SpringVerify — package already chosen at the recruitment step.
  5. ✅ Pre-offer checks run. 📊 One interim report pushed back to Recruitment — one time only.
  6. Offer released → candidate accepts → Onboarding form initiated.

🚀 Onboarding · After Offer Acceptance

  1. Onboarding form initiated — packages configured to match your SpringVerify packages.
  2. When should verification start? (your choice, pick one):
    • On form submission
    • On candidate activation
    • On first form update
  3. Candidate details + documents flow to SpringVerify — verification begins.
  4. ✅ Background verification in progress. Interim reports pushed as individual checks complete.
  5. 📄 Final report delivered to the Verification Reports section of the onboarding form.

03  How Each Module Behaves

The rules that differ between starting in Recruitment vs Onboarding — triggers, reports, and packages.

Recruitment (Before the Offer) Onboarding (After Offer Acceptance)
Trigger Instant notification created in DarwinBox, paired with a verification package Your choice: form submission, candidate activation, or first form update
Fields sent Only fields allowed by the package — package must include every field the verification needs Candidate details + documents
Pre-BGV form Optional. If enabled, must be completed before Pre-BGV is initiated. Pre-offer appears below Pre-BGV in DarwinBox by default but must still be done first.
Interim reports Exactly one interim report, pushed once only — an early pre-offer signal Pushed as each check completes
Final report None — Recruitment gives an early pre-offer signal only Delivered to the Verification Reports section of the onboarding form

04  Running Both Together

When Recruitment and Onboarding are connected, there are two ways to set up intake — and package selection differs between them.

✔ Candidate Auto Numbering must be enabled in DarwinBox. Without it there is no continuation between a candidate in Recruitment and the same candidate in Onboarding — the two would be treated as unrelated people. This setting is what links them into one case.

✔ Verification has already started during Recruitment. Once the onboarding form is initiated, interim reports flow there, followed by the final report on completion.

Setup 1 — Recruitment is the only intake

Every candidate starts in Recruitment; Onboarding simply receives the continuing case.

  • Recruitment: the real verification package is chosen here, via a custom field.
  • Onboarding: a dummy package is enough — it only needs to open the onboarding form so reports can land there.

Setup 2 — Add candidates from both sides

You want candidate additions from Recruitment and directly from Onboarding.

  • Recruitment candidates: package selected in Recruitment.
  • Onboarding candidates: package selected in Onboarding — so real, correct packages must be configured there, not a dummy.
  • Match the packages. If a Fresher package is selected in Recruitment, select the Fresher package in Onboarding as well — they must correspond.

05  Who Picks the Package, and Where

The package defines which checks run and which candidate fields are collected. Where it’s chosen depends on where the case starts.

How the candidate is added Package in Recruitment Package in Onboarding
Recruitment → Onboarding (Onboarding is passthrough only) Real package — via a custom field at the recruitment step Dummy package — only to open the onboarding form
Recruitment → Onboarding (also adding candidates from both sides) Real package — via a custom field Same real package, matched — e.g. Fresher in Recruitment → Fresher in Onboarding
Directly in Onboarding — not used — Real package — matched to your SpringVerify packages

06  What Report Goes Where

Module Interim updates Final report
Recruitment One interim report, pushed one time only — an early pre-offer signal None
Onboarding Pushed as each check completes Delivered to the Verification Reports section of the onboarding form
⚠ Verification statuses must line up. DarwinBox keeps its own configurable list of verification statuses. It must contain exactly the statuses SpringVerify pushes — if we push Red, Amber and Green, all three must exist in DarwinBox’s verification statuses, or the result can’t be recorded against the candidate.

07  Prerequisites & Setup

A one-time setup, usually completed in a single session with your DarwinBox account team. This applies to both Recruitment and Onboarding unless noted.

Configured inside DarwinBox (by your DarwinBox account team)

  1. SpringVerify added as a BGV vendor.
  2. Verification packages created, matching your SpringVerify packages.
  3. Verification statuses configured to exactly match the statuses SpringVerify pushes — e.g. Red / Amber / Green.
  4. The relevant DarwinBox APIs enabled for the modules you’ve chosen.
  5. Candidate Auto Numbering enabled — required for Recruitment + Onboarding together.

Shared with SpringVerify (so we can connect to your DarwinBox)

  1. The BGV vendor ID — shared with SpringVerify once we’re added as a vendor.
  2. A DarwinBox user — created for the integration, with its username and password.
  3. The relevant API keys for your chosen modules.

Recruitment only — connecting the webhook

Recruitment runs on an instant notification, so the webhook must be configured in DarwinBox with two things: the webhook endpoint and an API key for authentication. SpringVerify can provide both — or you can find them yourself in the Integrations section of the SpringVerify portal.

Choices that shape your flow (set per company)

  • Which modules are on — Recruitment, Onboarding, or both.
  • Pre-BGV form (Recruitment) — optional short form for extra candidate details.
  • When verification starts (Onboarding) — on form submission, candidate activation, or the first form update.

SpringVerify × DarwinBox integration overview · Exact configuration — modules, verification start point, packages, and reports — is agreed during onboarding and can be tailored to your workflow.

    • Related Articles

    • 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 ...
    • Integration of SpringVerify with ZingHR

      Overview: SpringVerify integrates with ZingHR to automate the background verification (BGV) process. Once the integration is configured, a scheduled sync (runs every hour) fetches eligible candidates from ZingHR to SpringVerify for verification. ...
    • Integration of SpringVerify with FactoHR

      Overview: SpringVerify IN has developed integrations with FactoHR, enabling clients to use API Keys from the FactoHR platform. This integration streamlines and automates background verification processes within the FactoHR environment. ...
    • Integration of SpringVerify with Ashby ATS

      Overview SpringVerify IN 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 ...
    • 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 ...