Skip to main content

​
Overview

Firstwork integrates with Veriff for identity verification. Candidates complete verification sessions where they present identification documents and a selfie, and Veriff uses AI to verify their identity in real-time.

​
How It Works

​
Setup

1

Get Veriff API credentials

  1. Sign up at Veriff
  2. Obtain your API key and secret
2

Configure in Firstwork

Add Veriff integration in Settings > Integrations > Veriff.
3

Configure verification flow

Set up which hiring flow stages require identity verification.

​
Veriff Sessions

When a candidate needs to verify their identity:
  1. A Veriff session is created with candidate data
  2. The candidate receives a verification link
  3. They upload their ID and take a selfie
  4. Veriff processes the verification
  5. Results are returned to Firstwork

​
Session Status

StatusDescription
CreatedSession initialized
StartedCandidate opened verification link
SubmittedCandidate completed the verification flow
ApprovedIdentity verified successfully
DeclinedVerification failed
ExpiredSession timed out
Resubmission RequestedAdditional documents needed

​
Automation Integration

​
Veriff Action

The Veriff Action in automations:
  • Creates a verification session for the candidate
  • Sends the verification link via email or SMS
  • Monitors the session status
  • Processes results and updates application data

​
Processing Results

When Veriff returns results:
  1. Session status is updated
  2. Compliance rules evaluate the verification outcome
  3. Extracted data (name, DOB, document number) is stored
  4. Automations trigger based on the result

​
Verified Data

Veriff can extract and verify:
  • Full name
  • Date of birth
  • Document number
  • Document expiry date
  • Nationality
  • Document type
  • Face match confidence
This data can be mapped to form fields and used in compliance rules.